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PREFACE 


The SYSTEM V/68 Administrator’s Manual (Part Number 41963-00, Product Code 72900) is 
intended to supplement the information contained in the UNIX System V User’s Manual and 
to provide an easy reference volume for those who administer the UNIX-derived operating 
system. 


While reasonable efforts have been made to assure the accuracy of this document, Motorola 
assumes no liability resulting from any omissions in this document or from the use of the 
information obtained therein. Motorola reserves the right to revise this document and to 
make changes from time to time in its content without being obligated to notify any person of 
such revision or changes. 
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INTRODUCTION 


1. GENERAL 


The Administrator's Manual is intended to supplement the information contained in the 
UNIX System V User's Manual and to provide an easy reference volume for those who must 
administer UNIX operating system. Accordingly, only those commands and descriptions 
deemed appropriate for system administrators have been included here. 


On most systems, all entries are available online via the man(1) command. 


2. ADMINISTRATOR’S MANUAL ORGANIZATION 
2.1 Description of Contents 
The manual is divided into three sections: 


Section 1 (“System Maintenance Commands and Application Programs”) contains system 
maintenance programs such as fsck, mk fs, etc., which generally reside in the directory /etc; 
these entries carry a sub-class designation of “1M” for cross-referencing reasons. 


Section 7 (“Special Files”) discusses the characteristics of each system file that actually refer 
to an input/output device. The names in this section generally refer to device names for the 
hardware, rather than to the names of the special files themselves. 


Section 8 (“System Maintenance Procedures”) discusses crash recovery and boot procedures, 
facility descriptions, etc. 


2.2 Section Organization 


Each section consists of a number of independent entries of a page or so each. The name of the 
entry appears in the upper corners of its pages. Entries within each section are alphabetized, 
with the exception of the introductory entry that begins each section. The page numbers of 
each entry start at 1. Some entries may describe several routines, commands, etc. In such 
cases, the entry appears only once, alphabetized under its major name. 


The UNIX System V User's Manual, which contains sections 1 - 6, is organized in the same 
manner as this Administrator's Manual. Throughout the documentation, references to the 
contents of either manual are given as name(section). For example, chroot(1M) is a reference 
to the chroot entry in section 1M of the Administrator’s Manual. 


A table of contents and a permuted index derived from that table precede Section 1M. The 
permuted index contains entries from both the UNIX System V User's Manual and this 
volume, and on each “index” line, the title of the entry to which that line refers is followed 
by the appropriate section mumber in parentheses. This is important because there is 
considerable duplication of names among the sections, arising principally from commands that 
exist only to exercise a particular system call. 


2.3 Entry Format 

All entries are based on a common format, not all of whose parts always appear: 
NAME gives the name(s) of the entry and briefly states its purpose. 
SYNOPSIS summarizes the use of the program being described. 


DESCRIPTION provides additional information about the program or facility outlined in 
the “Name” and “Synopsis” parts. 


EXAMPLE gives an example(s) of usage, where appropriate. 
FILES gives the filenames that are built into the program. 
SEE ALSO gives pointers to related information. 


DIAGNOSTICS discusses the diagnostic indications that may be produced. Messages that 
are self-explanatory are not listed. 


WARNINGS points out potential pitfalls. 


BUGS gives known bugs and sometimes deficiencies. Occasionally, the suggested fix is also 
described. | 


2.4 Conventions 
_ A few conventions are used, particularly in Section 1 (“Commands”): 
Boldface strings are literals and are to be typed just as they appear. 


Italic strings usually represent substitutable argument prototypes and program names 
found elsewhere in the manual. Note that this convention is not used in the “SYNOPSIS” 
or “SEE ALSO” part. 


Square brackets [] around an argument prototype indicate that the argument is optional. 
When an argument prototype is given as name or file, it always refers toa filename. 


Ellipses ... are used to show that the previous argument prototype may be repeated. 


A final convention is used by the commands themselves. An argument beginning with a 
minus -, plus +, or equal sign = is often taken to be some type of flag argument, even if it 
appears in a position where a filename could appear. Therefore, it is unwise to have files 
whose names begin with -, +, or =. 


li 
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ar: archive and library maintainer for portable 

cpio: copy file 

asin, dasin: FORTRAN 

atan2, datan2: FORTRAN 

atan, datan: FORTRAN 

aimag, dimag: FORTRAN imaginary part of complex 
getarg: return FORTRAN command-line 

varargs: handle variable 

vsprintf: print formatted output of a varargs 

Xargs: construct 

getopt: get option letter from 

expr: evaluate 


echo: echo > 


be: arbitrar y-precision 
expr: evaluate arguments 
asa: interpret 


ascii: map of 


acctdusg, accton, acctwtmp: overview of accounting . . 


acctmerg: merge or add total accounting files. .... 
accton, acctwtmp: overview of accounting and 
acctprcl, acctprc2: process accounting. 


e e e e e e e 


- acctme 


» acctpre(1M) 


acct(1M) 
1M) 


acct(1 


acctprc2: process accounting. ....... ee es « acctpre(iM) 
acctwtmp: overview of accounting and miscellaneous . acct(1M) 
acia: Asynchronous Communications Interface .. . . acia(7) 
acos, atan, atan2: trigonometric functions. ...... trig(3M) 
acos, dacos: FORTRAN arccosine intrinsic function. . acos(3F) 
active processes. 2... ee ee ee eee ew ee we © RillallC1M 
activity graphh ......... Se ae, eee, a we SEGOG) 
activity report package. . 2... 2. eee ee eee sar(1M) 
activity reporter. aattee ahe, Tek AS: top cbr we tee Wat 6 » » sar(l) 
QCUIVICVs:. 55s, ose a Re Ao oe BSS tes AS ae Sw 4 SACL) 
activity. timex: .. 1... eee eee eee eee timex) 
Adapter -6-4006- Wa ao Ba ee oe eee, Se BCMA) 
add total accounting files. ......... . ee +» acctmerg(1M) 
add value to environment. ...... ae ee putenv(3C) 


admin: create and administer SCCS files. ..... 


. . admin(1) 


administer SOCS files. . 2.0 eee cee eevee s admin(1) 
aimag, dimag: FORTRAN imaginary part of complex . aimag(3F) 
aint, dint: FORTRAN meee part intrinsic ..... . aint(3F) 
lara COCKS: ay. ie AoW es: a eee ee eee ee alarm(2) 
alarm: set a process’s alarm clock. ......44. . alarm(Q) 
SlGOnthMis (69% o 4. WR aS BS SI Ss SOS Ses, BB crypt(3C) 
BI GCAtiOns, i. 4.) sha awe aed Aes Ga Sos Ge we Se Ew . . brkQ) 
allocator, . 2... se 16} Ben Ne (oe tes Rad Sen ae ra malloc(3C) 
allocator. malloc, free, realloc, oe ee ew ew ew ee © 6 Malloc(3X) 
allow /prevent LP requests. ....-.-e-e0es 4. . accept(1M) 
_alog, dlog, clog: FORTRAN natural logarithm 2 2 ee + lop(3F) 
alog10, dlog10: FORTRAN common logarithm intrinsic 10g 10(3F) 


amax0O, max1, amax1, dmaxl: FORTRAN maximum-value max(3F) 


amaxl, dmaxl: FORTRAN maximum-value functions. . 


max(3F) 


aminO, minl, aminl, dminl: FORTRAN minimum-value min(3F) 


aminl, dminl: FORTRAN minimum-value functions. . min(3F) 
amod, dmod: FORTRAN remaindering intrinsic . . . . mod(3F) 
anal yZer. e e e e e e e e e e e e es e se e e e e e e fsba(1M) 


ii 


and, or, xor, not, Ishift, rshift: FORTRAN bitwise . . . bool(3F) 
and/or merge files. i Cis Ce Cee Se Bas. a SOD 
anint, dnint, nint, idnint: FORTRANnearest integer . . round(3F) 
a.out: common assembler and link editor output. .. . a.out(4) 
aout header. ... 2.2... So ee a 6a ee Sw av BOUth A) 
aouthdr: optional aout header. . .......... =. aouthdr(4) 
application programs. .....-ee see eee © intro) 
application programs. intro: ............ introdlM 
ar: archive and library maintainer for portable .... ar(1) 

ar: common archive file format. ........... ar4) 
arbitrary-precision arithmetic language ....... be(1) 
arccosine intrinsic function. . . . 2... ee © es . acos(3F) 
archive and library maintainer for portable ..... ar(1) 
ATCHI VE. 24 oe see: Sieh Wa) a> he eS a eee: oe DIO) 
archive file format. ......... oe ew ee ee a4) 
archive file. ... 2.2... eee eee eee oe © ~ Idahread(3X) 
archive header of a member of an archive file. .. . . Idahread(3X) 
ATCHIVG!:.. 65238 oa «4a Oe ee are ee oe: CAT 
SPChiVGR:. <a 4 Sw GR Rae 2! WS ew w OTD 
archives in and out. . 2... 2. ee ee ee ee es CPi) 
arcsine intrinsic function. ....... ++ ee. asin(3F) 
arctangent intrinsic function. ............ atan2(3F) 
arctangent intrinsic function. ............ atan(3F) 
argument... 1... ee eee ee ee ee we we ee  aimag(3F) 
argument. .. 1... ee eee eee ee ee ee ee petarp3F) 
argument list. 2... 6 eee ee eee ee oe] © Vararges) 
argument list. vprintf, vfprintf, ........ . . vprintf(3S) 
argument list(s) and execute command. ....... 1) 
argument vector. ......0020+0-0200c0  getopt(3C) 
arguments as an expression. . . . 2... - 2 ee es Exprl) 
arguments. ...... el atia ae aa eee eee SCD L) 
arithmetic language. 2.1... ee ee ee ee es OC) 
arithmetic: provide drill in number facts. .... . . arithmetic(6) 
as an expression. . 2... 0 ee ee ee ew es expr(1) 
as: common assembler. . . 2... 225-022 02 aXl) 
ASA carriage control characters. ....... +... asa(l) 

asa: interpret ASA carriage control characters. .. . . asa(1) 
ASCII character set. 2 2... 2-2-2222... ascii(S) 


164a: convert between long integer and base-64 
atof: convert 

ctime, localtime, gmtime, 

sin, cos, tan, 


help: 
a.out: common 
as: common 


assert: verify program 
setbuf, setvbuf: 
acia: 


Sin, COS, tan, asin, acos, 


function. 

sin, COS, tan, asin, acos, atan, 
number. 

strtod, 

strtol, atol, 

strtol, 

wait: 


ungetc: push character 


back: the game of 

filesave, tapesave dail y/weekly SYSTEM V/68 file system 
fine: fast incremental 

frec: recover files from a 


terminfo: terminal capability data 
a641, 164a: convert between long integer and 
vi: screen-oriented (visual) display editor 


shell scripts. bre, 


cb: C program 
J, ji, p, yO, yl, yn: 


cpset: install ob ct files in 

fread, fwrite: 

bsearch: 

tsearch, tfind, tdelete, twalk: manage 
and, or, xor, not, Ishift, rshift: FORTRAN 


bf the game of 

fsba: file system 

beopy: interactive 

sum: print checksum and 
sync: update the super 

df: report number of free disk 
restart on EXORmacs. 

and, or, xor, not, Ishift, rshift: FORTRAN bitwise 
EXDRmacs. bo.macs: 
VME/10. bo.vme: 

restart on VME/10. 

shell scripts. 


programs. 


stdio: standard 
setbuf, setvbuf: assign 
mknod: 

swab: swap 

cc: 

SCC: 

cflow: generate 
cpp: the 

ch: 

lint: a 

cxref: generate 


Permuted Index 


ascii: map of ASCII character set. .....5 200s ascii(S) 
ASCTI string. a641, ........ we ee ee es a64103C) 
ASCI string to floating-point number. ....... . atof(3C) 
asctime, tzset: convert date and time to string. ... . ctime(3C) 
asin, acos, atan, atan2: trigonometric functions. . .. . trig(3M) 
asin, dasin: FORTRAN arcsine intrinsic function. .. . asin(3F) 
ask forhelp,. ....... Lait ee wae ee eee help(1) 
assembler and link editor output. ...... oe ee acout(4) 
BSSEMIDIENS so thew osee sy wo, oS iteh er rey Siw ney eye ose, OR) 
assert: verify program assertion. ...... oe ee » assert(3X) 
ASSETLIONS...G, 25-6. so NWS dk A ice. ae Gee. eee assert(3X) 
assign buffering toastreaam. ......--.-0262- setbuf(3S) 
Asynchronous Communications Interface Adapter. . . acia(7) 
at, batch: execute commands ata latertime .... . at(1) 
atan, atan2: trigonometric functions. ......... trig(3M) 
atan, datan: FORTRANarctangent intrinsic function. . atan(3F) 
atan2, datan2: FORTRAN arctangent intrinsic .. . . atan2(3F) 
atan2: trigonometric functions. ......2-. ee. trig(3M) 
atof: convert ASCII string to floating-point .... . . atof(3C) 
atof: convert string to double-precision number. . .. . strtod(3C) 
atoi: convert string to integer... 1... ee ee ee strtol(3C) 
atol, atoi: convert string to integer. ..... . . .. strtol(3C) 
await completion of process. .....-2ee0- » « wait(1) 
awk: pattern scanning and processing language . . . . awk(1) 
back into input stream. 2... 1.6 ee we weer ungetc(3S) 
back: the game of backgammon. .. 1.2.1... back(6) 
back Ganimon:: <i: 4: 4 eGR © e BCS ie ee a back(6) 
GaCkUDs. 6 6: taps awe Ms ae 2 +e +» filesave(1M) 
backup. . mi clapligh Wee 1S gs SAN ak Ohm pein c carr den ie, tes de finc( 1M) 
backup tape... 2. eee ee ee eee Sere tee frec(1M) 
banner: make posters. .. 6. 2s eee eee eee banner(1) 
haan ae Ge a. ite! AG A ae oh aces Lermanto4) 
base-64 ASCII string. . 2... 2 2 ee eee ee ee a641(3C) 
based On GI %.soss, 92-6) Sr 4; eyes Wises Bre i ee anaes NACL) 
basename, dirname: deliver portions of pathnames. . . basename(l) 
batch: execute commands at a latertime. ....... at(1) 
be: arbitrary-precision arithmetic language. ...... be(1) 
bcheckre, rc, powerfail: system initialization ... . . bre(1M) 
bcopy: interactive block copy. . .... 2... beopy(1M) 
bdiff: file comparator for large files. ...... . . . bdiff(1) 
DeAUtI hts oe hw Sete. Wee Saas ee » «6 « chi) 
Bessel: fUnctions. sas aa wah Be ea we a ew es bessel(3M) 
brevbig fle scanner. 4.966 Wo% hak a a eee SES bfs(1) 
binary directories. . 2... 2 eee eee oe 6 es cpset(1M) 
binary input/output. . 2... 2 ee ew ee ee ewe fread(3S) 
binary searchh .. 1... bs ares oy Jes Te ee ee bsearch(3C) 
binary search trees. 2... 2 ee ee eee ewe tsearch(3C) 
bitwise Boolean functions. ......-65.0200684 bool( 3F) 
bj the game of blackjack. . 2. 11 1 1 0 ee ee we DFG) 
DIACK BOK so: car 8 mates: Se Ew en eee le eS ee b{6) 
DINGk-anal 76ers. a % ee eal A ee es fsba(1M) 
DIOCK OPV 8-49 8 sanehiece ees wee ee beopy( 1M) 
block count Of a: file.. 6. a @ 4-6 6 wise ee a ee sum(1) 
IOC Ns sods hoon ee wee A ase hy ENS ey ea aes ed sync(1) 
DIO Ses aa bien chants serves 4, a ae es bi ee a ew! df(1M) 
bo.macs: bootstrap operating procedure for system .. . bo.macs(8) 
Boolean functions. .. 1.656. eee eee ee » « bool(3F) 
bootstrap operating procedure for system restarton . . bo.macs(8) 
bootstrap operating procedure for system restarton .. bo.vme&8) 
bo.vme: bootstrap operating procedure for system .. . bo.vme(8) 
bre, bcheckre, rc, powerfail: system initialization . . . bre(1M) 
brk, sbrk: change data segment space allocation. . . . . brk(2) 
bs: a compiler/interpreter for modest-sized ...... bs(1) 
bsearch: binary searche . 2... ee eee . ee © bsearch(3C) 
buffered input/output package. .......... . stdio(3S) 
buffering toastream. ......02250000200- setbuf(3S) 
build special fle. .. 2.2... 22 eee tes it Sar. eats mknod(1M) 
BYES aed Benge os ek ae OS Bae » ee « swab(3C) 
Ccompiler. ......2.206-. Sigh na see obs se - - ec(l) 
C compiler for stand-alone programs. ..-...-. sec(1) 
C flow graph. ...... as ee ee a ee ae cflow(1) 
C language preprocessor, 2... 2. ee eee eee 1) 
C program beautifier. ...... be ave Cle, cess tes is tse op 1) 
C program checker. 1... 2.2 002 ee eee ee © lint(l) 
C program cross-reference. ....-.-2222006. cexref(1) 


Permuted Index 


ctrace: 


abs, iabs, dabs, 


dc: desk 
cal: print 


3 cu: 
Stat: data returned by stat system 

malloc, free, realloc, 

allocator. malloc, free, realloc, 

intro: introduction to system 

link, unlink: exercise link and unlink system 
Ip, 

terminfo: terminal 

pnch: file format for 

asa: interpret ASA 

cm 16: 16Mb 

cm 80: 80Mb 

Driver. cmd16: 16Mb 

Driver. cmd80: 80Mb 

edit: text editor (variant of ex for 


cos, dcos, 


absolute value functions. floor, 
floor, ceil, fmod, fabs: floor, 
exp, dexp, 


delta: make a delta 

pipe: create an interprocess 

real, float, sngl, dble, cmplx, dcmp1x, ichar, 
ungetc: push 

cuserid: get 

getc, petchar, fgetc, petw: get 

putc, putchar, fpute, putw: put 

ascii: map of ASCII 

asa: interpret ASA carriage control 

tolower, _toupper, _tolower, toascii: translate 
isprint, isgraph, iscntrl, isascii: classify 

tr: translate 

nulladm, prctmp, prdaily, prtacct, runacct,/ 


fsck, dfsck: file system consistency 


lint: a C program 

pwek, grpck: passw ord/group file 

checkall: faster file system 

volcopy, labelit: copy file systems with label 


sum: print 
chess: the game of 


chown, 
times: get process and 
wait: wait for 


prctmp, prdaily, prtacct, runacct,/ chargefee, 
ispunct, isprint, ispraph, iscntrl, isascii: 
uuclean: uucp spool directory 

clri: 

ferror, feof, 

alarm: set a process’s alarm 

cron: 


log, alog, dlog, 
ldclose, ldaclose: 
close: 


C program debugger. ........ Bilge et ee eee ctrace(1) 
cabs, zabs: FORTRAN absolute value... ....... abs(3F) 
Cali print calendars. <6 <j. ates: a eet oc eS Sw wo AID) 
CAlCUulator.. “i656 a ww ew aw! a See ye ee. eee SD 
CAICNGATIS te Be Arsengni ay She eee a ah a tes ee eh dor, ew I) 
calendar: reminder service. ......... +. « calendar(1) 
call another SYSTEM V/68 system. ....... » « cucic) 
Calls. aes Soe: 3 eee ee ee ee . . stat(S) 
calloc: main memory allocator. ......-e-22e6- malloc(3C) 
calloc, mallopt, mallinfo: fast main memory ... . . malloc(3X) 
calls and error numbers. «1.1.2.2 eee ee eee intro(2) 
CASS hake ofa! Goat Teeter ee .» link(1M) 
cancel: send/cancel requests to an LP line printer. . . . Ip(1) 
capability data bass... ..+2-0-42-2--.. terminfo(4) 
card images. » 2. ee ee ee ee eee ee . . pneh(4) 
carriage control characters. .. . bere » » . asa(1) 
Cartridge Module Drive for Universal Disk Driver. . . cm16(7) 
Cartridge Module Drive for Universal Disk Driver. . . cm80(7) 
Cartridge Module Drive for VM21 Driver and VM22  . cmd16(7) 
Cartridge Module Drive for VM21 Driver and VM22_ . cmd80(7) 
ChStial USERS): rg ete Seer oe ee Se cs Baa SS edit(1) 
cat: concatenate and print fle. ......... » . cat) 

cb: C program beautifier. 2... 2... 2. ee ee eee cb(1) 

66> C COMPLET. 526) ao So6 Gee < e - . ce(1) 

ccos: FORTRAN cosine intrinsic function. ...... cos(3F) 

cd: change working directory. .......+0-00-. cd(1) 

cdc: change the delta commentary of an SOCS delta. . . cdc(1) 

ceil, fmod, fabs: floor, ceiling, remainder, ...... . floor(3M) 
ceiling, remainder, absolute value functions. ..... floor(3M) 
cexp: FORTRANexponential intrinsic function. . . . . exp(3F) 
cflow: generate C flow graph. ..... 2.22 ee ee cflow(1) 
(change) to an SCCS fle. 2... 2. ee eevee delta(1) 
GHANOels: . <o Wond we S16. 6 See Oe I, ew ew Se pipe&2) 
char: explicit FORTRAN type conversion. /idint, . . . ftype(3F) 
character back into input stream. .......... ungetc(3S) 
character login name of the user. ........ . ~ cuserid(3S) 
character or word from stream. ........... getc(3S) 
character or word on a stream. .... +... putc(3S) 
character set. . 2... eee pica soe: ey Ae eews BSEILS) 
CHATACLOTSS Ab. 2S Ae A AS a eae ae asa(1) 
characters. toupper, . 2-2. eee ee we ee ee conv(3C) 
characters. /isxdigit, isalnum, isspace,ispunct, .. . . ctype(3C) 
CHATACtETSS. eee) ee bar ees 4 te 
chargefee, ckpacct, dodisk, lastlogin, monacct, . . . . . acctsh(1M) 
chdir: change working directory. .......... chdir(2) 
check and interactive repair. ..... we ee ee © fsck(1M) 
checkall: faster file system checking procedure. .. . . checkall(iM) 
CHOCKELs sone WG: ce: ees tS este SS “Sr I a lint(1) 
Checkers... <6. @ & «6 4)-e Ses ow Os Ses ee ee pwcek(1M) 
checking procedure. .....-..00 » ss +. checkall(1M) 
CHECKING). acd, 6: heb ees ae ec a eo arene, SE Se a eR volcopy(1M) 
checklist: list of file Geens processed by fsck. ... . checklist(4) 
checksum and block count ofa file .....2.2..6. sum(1) 
CHESS Ae ts we ae Ol ee be Be ees ee ta . . chess(6) 
chess: the game of chess. 2... 4.2.52. 2 0200s chess(6) 
chgrp: change owner or group. ... ++ e«eesees chown(1) 
child process times. .......2e+eeeee.. times(2) 
child process to stop or terminate .......... wait(2) 
chmod: change mode. . 2... 2.2.62 eee ee chmod(1) 
chmod: change mode of file. ..........2... chmod(2) 
chow n: change owner and groupofa file ...... chown(2) 
chown, chgrp: change owner or group. . ..... . . chown(1) 
chroot: change root directory. ...... oes chroot(2) 
chroot: change root directory fora command. ... . . chroot(1M) 
ckpacct, dodisk, lastlogin, monacct, nulladm, ... . . acctsh(1M) 
classify characters. /isxdigit, isalnum, isspace, .. . . ctype(3C) 
clean-up. ...... re ae eee ee uuclean( 1M) 
CIEAL INOUE sy. 6a: food Wk: SA Ses ee » + elri(1M) 
clearerr, fileno: stream status inquiries. ....... . ferror(3S) 
C1OCK Ss 14095? as fae ita, Ghd. 0 cera da os, Bs Se . . . alarm(2) 
clock daemon. .......2-.-. ee eer cron( 1M) 
clock: report CPU time used. .....-226202000- clock(3C) 
clog: FORTRAN natural logarithm intrinsic function. . log(3F) 
close a common obgfet file. ...... 2.06... Idclose(3X) 
close a file descriptor. ........ ee eee close(2) 


iv 


fclose, flush: 


Disk Driver. 
Disk Driver. 
and VM22 Driver. 
and VM22 Driver. 


int, ifix, idint, real, float, sngl, dble, 


com b: 

files. 

nice: run a 

chroot: change root directory for a 

env: set environment for 

uux: UNIX-to-UNX system 

system: issue a shell 

nohup: run a 

getopt: parse 

sh, rsh: shell, the standard/restricted 

timex: time a 

records. acctcms: 

system: issue a shell 

test: condition evaluation 

time: time a 

xargs: construct argument list(s) and execute 
getarg: return FORTRAN 

overview of accounting and miscellaneous accounting 
intro: introduction to 

intro: introduction to system maintenance 
at, batch: execute 

graphics: access graphical and numerical 
install: install 

mk: how to remake the system and 

Stat: statistical network useful with graphical 
cdc: change the delta 

ar: 

aout: 


as: 

log 10, alog10, dlog10: FORTRAN 

ldfcn: 

Idopen, Idaopen: open a 

Idlitem: manipulate line number entries of a 
Idclose, ldaclose: close a 

ldfhread: read the file header of a 

seek to line number entries of a section of a 
Idohseek: seek to the optional file header of a 
seek to relocation entries of a section of a 

read an indexed/named section header of a 
Idnsseek: seek to an indexed/named section of a 
compute the index of a symbol table entry of a 
Idtbread: read an indexed symbol table entry of a 
ldtbseek: seek to the symbol table of a 
linenum: line number entries in a 

nm: print name list of 

reloc: relocation information for a 

scnhdr: section header for a 


syms: 

filehdr: file header for 

ld: link editor for 

size: print section sizes of 
comm: select or reject lines 
ipcs: report in ter-process 
stdipc: standard interprocess 
acia: Asynchronous 

diff: differential file 

bdiff: file 


Ige, lgt, lle, lit: string 

diff 3: 3-way differential file 
dircmp: directory 

regemp, regex: 

regexp: regular expression 


‘common ob fect file. 


Permuted Index 


close: close a file descriptor. 
close or flush a stream. 
clri: clear inode. ....... 4 ig 

cm16: 16Mb Cartridge Module Drive for Universal 
cm80: 80Mb Cartridge Module Drive for Universal 


e e e e e @ e e Ld ° 
e e e e e ® e e e e e e 


cmd 16: 16Mb Cartridge Module Drive for VM21 Driver 
cmd80: 80Mb Cartridge Module Drive for VM21 Driver 


e e e e ° 


cmp: compare two files. .... 


cmp1x, dcmplx, ichar, char: explicit FORTRAN type/ 


col: filter reverse line feeds. . 
comb: combine SCCS deltas. 
combine SCCS deltas. . 
comm: select, or refct lines common to two sorted 
command at low priority. 
command. 
command execution. 
command execution. 
command from FORTRAN .. 
command immune to hangups and quits. . . . 
command options. 
command programming language. ...... 
command; report process data and system activity. 
command summary from per-process accounting 
command. 
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command-line argument. 
commands. acctdisk, acctdusg, accton, acctwtmp: 
commands and application programs. 
commands and application programs. 
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commands ata latertime. ......6.. eo hos og 
COMMBHGS..< 6 SoS. Benes Bek es Ke Sw. ee 
commands. ....e-. er at Het lae , E eee wee Soe 
commands. . 2... «ese ee ee i Suh le: es ie Bier 
commands. .....e. Re eS. SR Ke ee ec 


commentary of an SCCS delta. ws : 
common archive file format. .......e-. 
common assembler and link editor output. ... 
common assembler. : 
common logarithm intrinsic function. ..... 
common ob pct file access routines. 
common ob ect file for reading. 
common obpct file function. Idlread, Idlinit, . . 
common object fle. . 2... 2 2 ee ew ee ew 
common obct file. 
common ob pct file. 
common ob ct file. 
common ob pct file. 
common ob ct file. 
common ob pect file 
common ob pet file. 
common ob f¢ct file 
common ob ct file. 
common obfct file. . 


Idlseek, 1dnl seek: 


e 


Idrseek, ldnrseek: 
Idshread, Idnshread: 
Idsseek, . 
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common ob ct file. 
common ob ct file. 
common ob ct file symbol table format. 
common ob ct files. 
common ob ct files. 
common ob pct files. 
common to two sorted files. . .... 
communication facilities status. 
communication package. 
Communications Interface Adapter. . 
comparator. ; 
comparator for large files. . . 2... 
compare two files. ‘ 
compare two versions of an SCCS file. 
comparision intrinsic functions. 
comparison. 
comparison. 
compile and execute a regular expression. .. . 
compile and match routines. 
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close(2) 
fclose( 3S) 
clri(1M) 
com 16(7) 
cm80(7) 
cmd 16(7) 
cmd80(7) 


chroot( 1M) 
env(1) 
uux(1C) 
system (3F) 
nohup(1) 
getopt(1) 
sh(1 
timex(1) 
acctcms( 1M) 
system(3S) 
test(1) 


at(1) 
graphics( 1G) 
install(1M) 
mk(8) 


Idfhread(3X) 
Id]seek(3X) 
Idohseek(3X) 
Idrseek(3X) 
Idsh read(3X) 
Idsseek(3X) 
Idtbindex(3X) 
Idtbread(3X) 
Idtbseek (3X) 
linenum(4) 
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regemp: regular expression 
term: format of 

ce: C 

£77: FORTRAN 77 

sec: C 

tic: terminfo 

yacc: yet another 

bs: a 

_ erf, erfc: error function and 
Wait: await 
aimag, dimag: FORTRAN imaginary part of 
con jg, dcon jg: FORTRAN 

pack, pcat, un pack: 

common ob¢et file. Idtbindex: 
cat: 

test: 


config.68: 

Ipadmin: 

function. 

con jg, dcon jg; FORTRAN complex 

fwtmp, wtmpfix: manipulate 

dial: establish an out-going terminal line 

acctcon 1, acctcon2: 

fsck, dfsck: file system 

rjestat: RJE status report and interactive status 
math: ‘math functions and 

mkfs: 

Xargs: 

Is: list 

toc: graphical table of 

csplit: 

asa: interpret ASA carriage 

ioctl: 

- fentl: file 

init, telinit: process 

msgctl: message 

semctl: semaphore 

/shmetl: shared memory 

fentl: file 

uustat: uucp status inquiry and job 

ve: version 

for all disk units supported by the M68KVM21 disk 
for all] disk units supported by the M68K VM2!1 disk 
for all disk units supported by the M68K VM22 disk 
vm22fmt: format disks on the VM22 disk 

tty: 


term: 

cmp|x, dcmplx, ichar, char: explicit FORTRAN type 
units: 

dd: 

atof: 

13tol, 1 tol 3: 

string. a64l, 164a: 

ctime, localtime, gmtime, asctime, tzset: 
processors. fscv: 

ecvt, fevt, gcvt: 

scanf, fscanf, sscanf: 

strtod, atof: 

strtol, atol, atoi: 

conv: obpet file 

dd: convert and 

beopy: interactive block 

Cpio: 

dcopy: 

voicopy, labelit: 

cp, ln, mv: 

uucp, uulog, uuname: unix to unix 
uupick: public UNIX System-to-UNIX System file 


core: format of 
mem, kmem: 


functions. sin, 


COMPUCS 4. ar pineie be Ses eS wie oe ee ee Tegemp(1) 
compiled term file. ..... nay ee oe ee «© term(4) 
COMpileh: d-%. 422533 Hoe Se So ee ee ee ee 
COMPIUels x so Ace Soe. Bia ee eae. Sh ce ae er) 
compiler for stand-alone programs. ......+.. . sec(1) 
COMPILE. 6:66 GATS Oe ESS WS BH tic(1M) 
éonipiler-comipilety: 6.6. @ 420s. Se Slave SSeS. x yace(1) 
compiler/interpreter for modest-sized programs. . bs(1) 
complementary error function. .......-. . + « erf(3M) 
completion of process. . 2... eee ee eee . + « wait(1) 
complex Areumente a: & ot ti ck ter ae tate whan Se: a Hla aimag(3F) 
complex conjugate intrinsic function. ....... . conj3F) 
compress and expand files. ......-2s20e000-6 pack(1) 
compute the index of a symbol table entry of a... . Idtbindex(3X) 
concatenate and print files. ..... ee eee eee cat(1) 
condition evaluation command. .......+... . test(1) 
config.68: configure SYSTEM V/68. ........ .~ config.68(1M) 
configure SYSTEM V/68. 2... 2 ee ee ee ee we config.68(1M) 
configure the LP spooling system. ...-...- . . lpadmin(1M) 
con jg, dconp: FORTRAN complex con jugate intrinsic . con jg(3F) 
conjugate intrinsic function. .....-..e.e.. . . . conj3F) 
connect accounting records. .. 1... ee ee eee fwtmp(1M) 
CONNECUONS... o.%o.a0ce- 4.4 425c es ah ale ytd ~ dial(3C) 
connect-time accounting. ........ ee . acctcon(1M) 
consistency check and interactive repair. ....... fsck(1M) 
CONSO] CF ik <8 gov eal Ses 8 ere ee ee ee rjestat(1C) 
COM SCAN USS see ay a, 28a Asai Ge hp x Oe ee Bee math(S) 
construct a filesystem. ... 2... 2 ee eee eee mkfs(1M) 
construct argument list(s) and execute command. . .. xargs(1) 
contents of directories. NENG Sa i ies Deh gh agg a .. si 
contents routines. 2... ee ee ee ew ee » « « toc(1G) 
CONLERtSDlits:. “acs Hee ee SS a ws: oo e « « » esplitti) 
control characters. 2.65 sees ee ce ee ew » asad) 
Control -Cevicts-s. sae cee ew eine wee Vee Ow SO a TOC) 
COMUTOl sa. Gs. Beare. HS di cet asche Bp Grohe eS SPCR) 
cotitrel initialization: «cua: sig obs St rae) ener aye TA ECD) 
control operations. . 2... 6605 ee ee we ee msgeti(2) 
control operations. . ge cuctewig tia. ies Gece. w? Sees. @: ge SEMICtLCD) 
control operations. . 1... 6 2 es 6 ee ew © © © © Shmetl(2) 
control options. SE etal Wear Soe eb sew ae ECU) 
control. ..... Se vientet ae ats 5G Silas ew a S's: & we StatC1C) 
control. . 2... ee ih Rew aoe Sue VOD 
controller. ud: general driver ..... ict aat i oe ud(7) 
controller. vm21: default general driver . .... . . vm21(7) 
controller. vm22: default general driver ....... vm22(7) 
controller... 2... 2 eee wwe ee ee ee ee VM22Fmt( 1M) 
controlling terminal interface ..... a ee tty(7) 
conv: obgct file converter. ....... oe ee es Conv(l) 
conventional names for terminals. .......... term(S) 
conversion. /ifix, idint, real, float, sngl,dble, . . . ftype(3F) 
conversion program. ... 2.2... + eee eee © units(l) 
convert and copya file. ......... wee ee Gd) 
convert ASCII string to floating-point num ber. 2 + » « atof(3C) 
convert between 3-byte integers and long integers. . . 13tol(3C) 
convert between long integer and base-64 ASCIT .. . a641(3C) 
convert date and time to string. ........... cetime3C) 
convert files between M68000 and VAX-11/780 . . . fscv(1M) 
convert floating-point number to string. ...... . ecvt@C) 
convert formatted input. ........2.s..s.+.-. scanf(3S) 
convert string to double-precision number, . 0. 0 6s strtod(3C) 
convert string to integer. .......206-... strtol(3C) 
converter. .... se. aw SOR ee Be ae ee ae %, CORVED 
copy a file. ee 
CODY oo sa elevke) ee ees ieee ae SA A ee Se ee, CDC MD 
copy file archives in and out. 1... . 2.22 e eee “sia 1) 
copy file systems for optimal access time. . . ... . . deopy(1M) 
copy file systems with label checking. . ..... .. « volcopy(1M) 
copy, link or move files. 2... ... ee ee eee + Cpl) 
copy. eee tee eee eee ee ee ee eo TUCPLIC) 
COPY. WULO) See WS. Doe ee So ee 8% Saw MUO) 
core: format of core image file. .......... . coreé4) 
core image file. . 2.1... 26 252 ee ee oe oe - COre4) 
core memory. .. 2s see e eee ee ee ee © » mem”) 
cos, dcos, ccos: FORTRAN cosine intrinsic function. . . cos(3F) 
cos, tan, asin, acos, atan, atan2: trigonometric . .. . . trig(3M) 


vi 


function. 

sinh, 

cos, dcos, ccos: FORTRAN 

cosh, dcosh: FORTRAN hyperbolic 
sum: print checksum and block 
we: word 


cpio: format of 


clock: report 
craps: the game of 


crash: what to do when the system 
one. 

tmpnam, tempnam: 

creat: 

fork: 

tm pfile: 

pipe: 

admin: 

umask: set and get file 


crontab: user 


cxref: generate C program 
Curses: 

algorithm. 

sin, dsin, 


sqrt, dsqrt, 


date and time to string. 


ttt; 

uname: get name of 

sact: print 

uname: print name of 

ttyslot: find the slot in the utmp file of the 
getcwd: get pathname of 

package. 

spline interpolate smooth 


file. 
cut: 


abs, iabs, 

acos, 

cron: clock 

errdemon: error-lopging 

errstop: terminate the error-logging 
lpd: line printer 

runacct: run 

filesave, tapesave: 

300, 300s: handle special functions of 
450: handle special functions of the 
asin, 

timex: time a command; report process 
terminfo: terminal capability 
diskusg: generate disk accounting 
sputl, sgetl: access long integer 

_ plock: lock process, text, or 

prof: display profile 

Stat: 

ork, sbrk: change 

types: primitive system 

pin: relational 

tput: query terminfo 

atan, 


cosh, dcosh: FORTRAN hyperbolic cosine intrinsic 


cosh, tanh: hyperbolic functions. 
cosine intrinsic function. 
cosine intrinsic function. 
count of a file. 
COUNT. 402%. eda 
cp, In, mv: copy, link or move 2 files. 
cpio archive. ...... 
cpio: copy file archives in and out. .... . 
cpio: format of cpio archive. 
cpp: the C language preprocessor. ..... 
cpset: install ob pct files in binary directories. 
CPU time used. 
craps. 
craps: the game of craps. 
crash: examine system images. 
crash: what to do when the system crashes. 
crashes, 
creat: create a new file or rewrite an existing 
create a name for a temporary file. 
create a new file or rewrite an existing one. 
create a new process. 
create a temporary file. .. 
create an interprocess channel. ... 
create and administer SOCS files. .. 
creation mask. 
cron: clock daemon. 
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cosh(3F) 
sinh(3M) 
cos(3F) 


. cosh(3F) 
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clock(3C) 
craps(6) 
craps(6) 
crash( 1M) 
crash.macs(8) 
crash.macs(8) 
creat(2) 

tm pnam(3S) 
creat(2) 
fork(2) 

tm pfile(3S) 
pipe(2) 


. admin(1) 


crontab file. e e e e e e e e e e e e e e e e e 
crontab: user crontab fle. . ..... 2 2 ee 
cross-reference. ee ee e e e ee # ee 8 @ @®@ 


CRT screen handling and optimization package. 


crypt, encrypt: a one way hashing encryption 
csin: FORTRAN sine intrinsic function. 
csplit: context split. 
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e e e 


csqrt: FORTRAN square root intrinsic function. 


ct: spawn petty to a remote terminal. 
ctermid: generate filename for terminal. 
ctime, localtime, gmtime, asctime, tzset: 
ctrace: C program debugger. . 
cu: call another SYSTEM V/68 system. 
cubic: tic-tac-toe . 2... 2 6 2 ew 
current operating system. 
current SOCS file editing activity. .. 
current UNIX System. 
current user. 
current working directory. .. 
curses: CRT screen handling and optimization 
curve. 
cuserid: get character login name of the user. 
cut: cut out selected fidds of each lineofa . 
cut out selected fields of each line of a file. . 
cxref: generate C program cross-reference. . 
dabs, cabs, zabs: FORTRAN absolute value. . 
dacos: FORTRAN arccosine intrinsic function. 
daemon. 
daemon. 
daemon. 
daemon. 
daily accounting. 
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daily/weekly SYSTEM V/68 file system backup. 


DASI 300 and 300s terminals. 
DASI 450 terminal. 
dasin: FORTRAN arcsine intrinsic "function. 
data and system activity. ...... 
data base. 
data by user ID. 
data in a machine independent fashion.. 
data in memory. .......-«.eo-. 

Gates @ 6s ee Oo wwe ee 
data returned by stat system call. 

data segment space allocation. . . 
data types. 
database operator. 
database. 
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datan: FORTRAN arctangent intrinsic function. 
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umask(2) 
cron(1M) 
crontab(1) 
crontab(1) 
cxref(1) 
curses(3X) 
crypt(3C) 
sin(3F) 
esplit(1) 
sqrt(3F) 
ct(1C) 
ctermid(3S) 
ctime(3C) 
ctrace(1) 
cu(1C) 
ttt(6) 
uname(2) 
sact(1) 
uname(1) 
ttyslot(3C) 
getcwd(3C) 
curses(3X) 
spline(1G) 
cuserid(3S) 
cut(1) 
cut(1) 
cxref(1) 
abs(3F) 
acos(3F) 
cron(1M) 
errdemon( 1M) 
errstop(1M) 
Ipd(1C) 
runacct(1M) 
filesave(1M) 
30001) 
450(1) 
asin( 3F) 
timex(1) 
disk 
sputl(3X) 
plock(2) 
prof(1) 
stat(S) 
brk(2) 
ea 
pin(1) 
tput(1) 
atan(3F) 
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oe atan2, 
— ctime, localtime, gmtime, asctime, tzset: convert 
date: print and set the 


type/ int, ifix, idint, real, float, sngl, 


int, ifix, idint, real, float, sngl, dbie, cmplx, 
function. con p, 


Cos, 
function.. cosh, 


functions. dim, 

ctrace: C program 

fsdb: file system 

sdb: symbolic 

by the M68K VM21 disk controller. vm21: 
by the M68K VM22 disk controller. vm22: 
sysdef: system 

basename, dirname: 

tail: 

cde: change the delta commentary of an SOCS 
delta: make a 

cde: change the 

rmdel: remove a 


comb: combine SCCS 
mesg: permit or 

close: close a file 

dup: duplicate an open file 
dc: 

ACCESS: 

file: 

dfile: 

master: master 

ioctl: control 

devnm: 

hpd, erase, hardcopy, tekset, td: graphical 


eXp, 


interactive repair. fsck, 
connection. 
tation rational FORTRAN 


dim, ddim, idim: positive 
sdiff: side-by-side 
diffmk: mark 

diff: 

diff 3: 3-way 


functions. 
aimag, 


aint, 


cpset: install object files in binary 

dir: format of 

ls: list contents of 

tm, rmdir: remove files or 

cd: change working 

chdir: change working 

chroot: change root 

uuclean: uucp spool 

dircmp: 

unlink: remove 

| chroot: change root 
getcwd: get pathname of current working 
mkdir: make a 

mvdir: move a 

pwd: working 

mknod: make a 
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datan2: FORTRAN arctangent intrinsic function. . . . atan2(3F) 
date and time to string. ......... oe ee e » ctime3C) 
GALE. 2. 6) Gio eek werd Bs Bais sie aisle Joe BG, GATE) 
date: print and set thedate. . . 2.2.2 2 eee ee date(1) 
dbie, cmplx, demplx, ichar, char: explicit FORTRAN . . ftype(3F) 
dc: desk calculator. . 2. 2 ee eee ee ee ew oe © OCI) 
dcmp1x, ichar, char: explicit FORTRANtype/ ..... ftype(3F) 
dcon jg: FORTRAN complex conjugate intrinsic ... . conj(3F) 
dcopy: copy file systems for optimal access time. . . . dcopy(1M) 
dcos, ccos: FORTRAN cosine intrinsic function. . . . . cos(3F) 
-dcosh: FORTRAN hyperbolic cosine intrinsic ..... cosh(3F) 
dd: convert and copya file. .......626.2006-6 dd(1) 
ddim, idim: positive difference intrinsic .... . dim(3F) 
GEDUPPET: <6) 6a oS a wie oS Se Se wo ew SO Ctrace 1) 
GebUGeer:. 4° 4.4 BU Ww eee he Ee &, & Soe F9DOM) 
debugger. ..... er ee eee eee, 
default general driver for all disk units supported .. vm21(7) 
default general driver for all disk units supported . . vm22(7) 
definition. .......66- Si wb, AR ssa Task. Sieh S85 » « sysdef(1M) 
deliver portions of pathnames. .......... . basenamel) 
deliver the last part ofafile .........2... tail(1) 
OCltAL Sch bee as ea iw ED, el ee a Bo oe . ede(1) 
delta (change) to an SOCS file... .......... delta(l) 
delta commentary of an SCCS delta. ......... ede(1) 
delta from an SCCS file. ......22-2 2c cece rmdel(1) 
delta: make a delta (change) to an SCCS file. oe es Gelta(1) 
deltas. ..... gh, Go) tas ae the Eat eet ae cas eae Sa comb(1) 
CRY IMESSACEE) Saas 15, sees he: ae. tap Yo Rreae Se oes mesg(1) 
descriptor. ....... ee er eee are eee rane 
descriptor, . 2... eee ee eee eee arn yd 2) 
desk calculator. . 2... 22s a ee ot) 
determine accessibility of a file. oe ee ee © access(2) 
determine filetype ........ gs, aa Rs arse Ser file(1) 
device information file. ............ . . . dfile4) 
device information tabla .......2.6. «+ + +» master.dec(4) 
GEViCG, Geo Ss ote Bee oe: © eae Bas eR ioctl(2) 
GQVicCe MAME. “6 4 ke SS Se eee SR ES devnm(1M) © 
device routines and filters. ........ 22 es gdev(1G) 
devnm: device name. ... 2.6... eee «ss + « devnm(1M) 
dexp, cexp: FORTRAN exponential intrinsic function. . exp(3F) 
df: report number of free disk blocks. .. 2... +. af 1M) 
dfile: device information fle. ............ dfile4) 
dfsck: file system consistency check and ....... fsck(1M) 
dial: establish an out-going terminal line . .... . . dial(3C) 
Gialects Bs bse. Se Se eee a we 8 SiR wet we ee, Tatton) 
diff: differential file comparator. ......... . . diff(1) 
diff 3: 3-way differential file comparison. ..... . . diff 3(1) 
difference intrinsic functions. ............ dim(3F) 
difference program. ...-..+.ee++ee eo © SGiff(1) 
differences between files. 2... 2... 200 eee . . diffmk(1) 
differential file comparator. . 2... 2+ +e eee diff(1) 
differential file comparison. . . ta Ge Bee. Set OID 
diffmk: mark differences between ae eae diffmk(1) 
dim, ddim, idim: positive difference intrinsic ... . . dim(3F) 
dimag: FORTRAN imaginary part of complex argument. aimag(3F) 
dinit: disk initializer. ........ oe ee ee © © Ginit(1M) 
dint: FORTRAN integer part intrinsic function. . . . . aint(3F) 
dir: format of difectories. . .. 6.5.5.2 eee dir) 
dircmp: directory comparison. . ......... . . diremp(1) 
directories. 2... ee ee ee ee ee ew ww oe © Cpset(1M 
GIFECHOTIOSS:. ai ave. o's 8 6s. WAS wt wo Se es ID 
directories. ee ere ee sitetees bas ASD) 
directories, 1... 0 eee eee eee ee ee ee MI) 
BITECHOTY:: oo: 6 e eel wee HH Oe ee gas Osea: a be OD 
GITECLOTY.: <6 Gos. So wo ee oS we ee ee © © Chdir(2) 
directory. . 2... ee ee ee ee we ee ee © © Chroot(2) 
directory clean-up. .. 6... +e e eee ee «© ~~ UUclean(1M 
directory comparison. .- 2. eee ee eee eee dircm p(1) 
directory entry. . 2. eee ee we ee eee ene unlink(2) 
directory foracommand. ....... tae: Se ae chroot( 1M) 
GISCCLOTY As Bie) 6. se te ide ee oe we SS getcwd(3C) 
GiFSClOry «Seco Sasa eee Se ee ee » mkdir(1) 
directory, ......6- sat dat ea ee de oe cas » « mvdir(1M) 
directory name. .. 2-6 ee eee ee eee . « pwd(l) 
anys or a special or eae file. oe ee ee ee 6 MKNOd) 


basename, 


enable, 

acct: enable or 

dis: 

getty: set terminal type, modes, speed, and line 

sadp: 

disk usg: generate 

df: report number of free 

driver for all disk units supported by the M68K VM21 
driver for all disk units supported by the M68K VM21 
driver for all disk units supported by the M68K VM22 
vm22fmt: format disks on the VM22 

sa400flwd: S¥%-inch Floppy 

fi8: 8-inch Floppy 

sa800f121: 8-inch Floppy 

~ $a400f22 S¥-inch Floppy 

sa800f122: 8-inch Floppy 

wd15: 1SMb Winchester 

wd40: 40Mb Winchester 

cm16: 16Mb Cartridge Module Drive for Universal 
cm80: 80Mb Cartridge Module Drive for Universal 
fi8: 8-inch Floppy Disk Drive for Universal 

Irk25: 25Mb LARK Module Drive for Universal 
5¥s-inch Floppy Disk Drive for the Winchester 

dinit: 

controller. ud: general driver for all 

controller. vm21: default general driver for all 
controller. vm22: default general driver for all 

du: summarize 

vm22fmt: format 


mount, umount: mount and 
vi: screen-oriented (visual) 
prof: 
hypot: Euclidean 
srand48, seed 48, lcong48: generate uniformly 
function. log, alog, 
function. log10, alog10, 
max, maxO, amaxO, max1, amax1, 
min, minO, aminO, minl, amin], 
mod, amod, 
functions. anint, 
prdaily, prtacct, runacct,/ charpefee, ckpacct, 
whodo: who is 
dprod: 
strtod, atof: convert string to 


reversi: a game of 

jpand 48, srand48, seed 48, lcong48: generate/ 
graph: 

arithmetic: provide 

sa400fiwd: 5¥%-inch Floppy Disk 

cm 16: 16Mb Cartridge Module 

cm 80: 80Mb Cartridge Module 

fi8: 8-inch Floppy Disk 

Irk25: 25Mb LARK Module 

cmd16: 16Mb Cartridge Module 

cmd80: 80Mb Cartridge Module 

_ lark25: SOMb LARK Module 
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log gamma function. . 2... 2 ee ee ee ww ws gam ma(3M) 
login toa new group, ........2. 2+... newgrp(l 
log, 1og10, pow, sqrt: exponential, logarithm, ... . . exp(3M) 
log10, alog10, dlogl0: FORTRAN common logarithm . 10g10(3F) 
log10, pow, sqrt: exponential, logarithm, power, .. . exp(3M) 
logarithm intrinsic function. ....... 20280 -. log 10(3F) 
logarithm intrinsic function. .......050286 log(3F) 
logarithm, power, square root functions. ....... exp(3M) 
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login name. ...... pbs ee ee ae ates as ade ee logname(1) 
login name of the user. . 2... 1. ee eee eee cuserid(3S) 
login name of user. .......6.. ee logname(3X) 
login password. ......-2-006- eae . passwd(1) 
JORIN @SIOHCONe,. si oe ar-d ae 4Y gh Oe Se ee te we login(1) 
IOPIN AIMS ae eek tes 6s ee, Eee eee ed . » profile(4) 
lopgname: get loginname. ........6-+020s000-4 logname(1) 
logname: return login name of user. ......... logname(3X) 
long integer and base-64 ASCII string. ........ a641(3C) 
long integer data in a machine independent ...... sputl(3X) 
long integers: <. s) 6 6 he wo ee eS we 13tol(3C). 
long jmp: non-local goto. 2... 1.2 ee ew ee wee set jm p(3C) 
lorder: find ordering relation for an obpct ...... lorder(1) 
LOW" DriOMtY.. Se eck Teco ew Wena we Hee Boe ee ee nice(1) 

Ip, cancel: send/cancel requests toan LP line ..... Ip(1) 

ECP TING Printers. 26: vos 6 als, eos HE a fa os Ip(1) 

lp: MVME410 line printer interface... ...... Ip(7) 

TP Printers; se2 ose aa tes cans 6k ee MA Bee eee es enable(1) 

LP request scheduler and move requests. ....... Ipsched(1M) 
TEP OQ UCSTS:, <2. ek oes Us wy es ee ses ais accept( 1M) 
LP spooling system. . 2... 2.2.5 es ee - « - Ipadmin(1M) 
LP status information. .......-02eeeee Ipstat(1) 
lpadmin: configure the LP spooling system. .... . . Ipadmin(1M) 
Ipd: line printer daemon. .. . (wine bo ed wh pale) 
Ipmove: start/stop the LP request scheduler and . « Ipsched(1M) 
Ipsched, lpshut, lpmove: start/stop the LP request . . . Ipsched(1M) 
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Irk2S: 25Mb LARK Module Drive for Universal Disk . Irk2S(7) 
ls: list contents of directories. .........2.es Is(1) 
lsearch, lfind: linear search and update. ....... lsearch(3C) 
lseek: move read/write file pointer, ......... lseek(2) 
Ishift, rshift: FORTRAN bitwise Boolean functions. . bool(3F) 


Itol3: convert between 3-byte integers and long ... 


. 13tol(3C) 


m4: macro processor, 2... 2. eee ee ee ee m4(1) 
m400: MVME400 Dual RS-232C Serial Port Module. . m400(7) 
M68000 and VAX-11/780 processors. .. 2.2.6.4: fscv(1M) 
m68k: provide truth value about your processor .. . machid(1) 
M68K VM21 disk controller. ud: .......4.. . ud(7) 
M68KVM21 disk controller. vm21: default ..... vm21(7) 
M68K VM22 disk controller. vm22: default ..... vm22(7) 
machine independent fashion. ........260+.6- sputl(3X) 
machine-dependent values. .......6-+6e26-. - values(S) 
MACTO pYocessOr, 2 6s we ee ee ewe we eee eee m4(1) 
Tidal so. 8 ce, e620 76 te) eve cx? ey le es ees oe. mail(1) 
mail, rmail: send mail to users or read mail. .... . mail(1) 
mail to users or readmail. ........ ee ss mail() 
mailx: interactive message processing system. .... . mailx(1) 
main memory allocator. ........ os ee © ~ malloc(3C) 
main memory allocator. malloc, ..... es se © malloc(3X) 
maintain, update, and regenerate groupsof ..... . make(1) 
maintainer for portable archives. .... 2.2... ar(1) 
maintenance commands and application programs. . intro(1M) 
maintenance procedures. ... 1... e500 e ees intro(8) 
make a delta (change) to an SCCS file. ........ delta(1) 
makea directory. ....+.-.4-+seese6-6 . +. + mkdir(1) 
make a directory, or a special or olny file. ... . mknod(2) 
make a unique filename ........-22e00- mktem p(3C) 
make maintain, update, and regenerate groups of . .. make(1) 
Make POStETS.. 66s: a oe eM BS ES ee Se ae banner(1) 
makekey: generate encryption key. ........ . makekey(1) 
mallinfo: fast main memory allocator. ...... » « malloc(3X) 
malloc, free, realloc, calloc: main memory ..... » malloc(3C) 
malloc, free, realloc, calloc, mallopt, mallinfo: .. . . malloc(3X) 
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tsearch, tfind, tdelete, twalk: 
hsearch, hcreate, hdestroy: 

shl: shell layer 

fwtmp, wtmpfix: 

file function. Idlread, Idlinit, ldlitem: 
frexp, ldexp, modf: 

man, 

man, Manprog: print entries in this 
ascii: 

diffmk: 

umask: set file-creation mode 
umask: set and get file creation 

mas ter: 


regexp: regular expression compile and 
math: 


maximum-value functions. 

maximum-value functions. max, 

functions. max, max0O, amax0O, 

max, maxO, amax0O, max1, amax1, dmaxl: FORTRAN 


maze: generate a 


operations. 

memccpy, 

memccpy, memchr, 

memccpy, memchr, memcmp, 

malloc, free, realloc, calloc: main 

free, realloc, calloc, mallopt, mallinfo: fast main 
shmctl: shared 

remove a message queue, semaphore set or shared 
mem, Kmem: core 

memccpy, memchr, memcmp, memcpy, memset: 
shmat, shmdt: shared 

plock: lock process, text, or data in 

sh meget: get shared 

memccpy, memchr, memcmp, memcpy, 

sort: sort and/or 

acctmerg: 

lines of one file. paste: 


msgcti: 

msgsnd, msgrcev: 

mailx: interactive 

MsPPet: ger 

ipcrm: remove a 

mesg: permit or deny 

perror, errno, sys_errlist, sys_perr: system error 
minimum -value functions. 

minimum-value functions. min, 

functions. min, minO, aminO, 

min, minO, aminO, min1l, aminl, dminl: FORTRAN 


file. 


functions. 

chmod: change 

umask: set file-creation 
chmod: change 

getty: set terminal type, 
bs: a compiler/interpreter for 
frexp, ldexp, 

touch: update access and 
utime: set file access and 
cm 16: 16Mb Cartridge 
cm80: 80Mb Cartridge 
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man, man prog: print entries in this manual. . 
manage binary search trees. . . 2... 2 2 es 
manage hash search tables. 
manipulate connect accounting records. 
manipulate line number entries of a common obfct 
manipulate parts of floating-point numbers. ... 
manprog: print entries in this manual. 
manual. ... 
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mark differences between files. 
mask. 
mask. 
master device information table. 
master: master device information table. 
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matherr: error-handling function. 
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man(1) 
tsearch(3C) 
hsearch( 3C) 
shi(1) 

fwtm p(1M) 
Idlread(3X) 


. frexp(3C) 


- man(1) 


man(1) 
ascii(S) 
diffmk(1) 
umask(1) 

um ask(2) 
master.dec(4) 
master.dec(4) 


. repexp(S) 


math(S) 
math(S) 
matherr( 3M) 
max(3F) 
max(3F) 
max(3F) 
max(3F) 
maze(6) 
maze(6) 
mclock(3F) 
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memccpy, memchr, memcmp, memcpy, memset: memory memory(3C) 
memchr, memcmp, memcpy, memset: memory operations. memory(3C) 


memcmp, memcpy, memset: memory operations. 
memcpy, memset: memory operations. 
memory allocator. 
memory allocator. malloc, 
memory control operations. 
memory id. ipcrm: 
memory. 
memory operations. 
memory operations. 
memory. 
memory segment. 
memset: memory operations. . .. 2... 22. ee e 
merge files. Slee we 
merge or add total accounting files. . . ee ae 
merge same lines of several files or subsequent ee 
mesg: permit or deny messages. 
message control operations. 
message operations. .. 

message processing system. 
message queue. 
message queue, semaphore set or shared memory id. . 
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messages. 
min, minO, aminO, minl, aminl, dminl: FORTRAN . 
minO, aminO, min1, aminl, dminl: FORTRAN ... 
minl, aminl, dminl: FORTRAN minimum-value .. 
minimum-value functions. . 
mk: how to remake the system and commands. ... 
mkdir: make a directory. 
mkfs: construct a file system. 
mknod: build special file. 
mknod: make a directory, or a special or ordinary . . 
mktemp: make a unique filename. 
mnttab: mounted file system table. 
mod, amod, dmod: FORTRAN remaindering intrinsic 
mode. 
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modes, speed, and line discipline. ‘ 
modest-sized programs. .......2.-. 
modf: manipulate part:. of floating-point numbers. . 
modification times of a file. 
modification times. . . . 2. 2. 2 6 e 
Module Drive for Universal Disk Driver. . ..... 
Module Drive for Universal Disk Driver. 
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memory(3C) 
malloc(3C) 
mall oc(3X) 
shmctl(2) 
ipcrm(1) 
mem(7) 
memory(3C) 
shmop(2) 
plock(2) 
shmget(2) 
memory(3C) 
ere .. 
acctmerp( 1 
paste(1) 
mesg(1 ) 
msgctl(2) 
msgop(2) 
mail x(1) 
msgget(2) 
iperm(1) 
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perror(3C) 
min( 3F) 
min(3F) 
min(3F) 
min(3F) 
mk(8) 
mkdir(1) 
mkfs(1M) 
mknod(1M) 
mknod(2) 
mktem p(3C) 
mnttab(4) 
mod(3F) 
chmod(1) 
umask(1) 
chmod(2) 


» getty(1M) 


bs(1) 
frexp(3C) 
touch(1) 
utime(2) 
om 16(7) 
cm80(7) 
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Irk25: 25Mb LARK 
cmd 16: 16Mb Cartridge 
cmd80: 80Mb Cartridge 

lark25: SOMb LARK 

lark8: 16Mb LARK 

m400: MVME400 Dual RS-232C Serial Port 
runacct,/ chargefee, ckpacct, dodisk, lastlogin, 


uusub: 


mou nt: 
mount, umount: 


setmnt: establish 


mottab: 

mvdir: 

cp, In, mv: copy, link or 

| Iseek: 

Ipmove start/stop the LP request scheduler and 
generate/ drand48, erand48, lrand 48, nrand48, 


log, alog, dlog, clog: FORTRAN 


anint, dnint, nint, idnint: FORTRAN 
Stat: statistical 
uusub: monitor uucp 


news: print 


anint, dnint, 


set mp, long jmp: 

functions. and, or, Xor, 

Icong48: generate/ drand48, erand48, lrand 48, 
null: the 


chargefee, a dodisk, lastlogin, monacct, 

nl: line 

graphics: access graphical and 

Idfcn: common 

conv: 

dump: dump selected parts of an 

Idopen, Idaopen: open a common 

jdlitem: manipulate line number entries of a common 
Idclose, Idaclose: close a common 

ldfhread: read the file header of a common 
ldgetname: retrieve symbol name for 

to line number entries of a section of a common 
seek to the optional file header of a common 

seek to relocation entries of a section of a common 
read an indexed/named section header of a common 
seek to an indexed/named section of a common 

the index of a symbol table entry of a common 
read an indexed symbol} table entry of a common 
Idtbseek: seek to the symboi table of a common 
linenum: line number entries in a common 

nm: print name list of common 

reloc: relocation information for a common 

scohdr: section header for a common 

strip symbol and line number information from an 
syms: common 


Module Drive for Universal Disk Driver... ..... Irk25(7) 
Module Drive for VM21 Driver and VM22 Driver. . . cmd16(7) 
Module Drive for VM21 Driver and VM22 Driver. . . cmd80(7) 
Module Drive for VM21 Driver and VM22 Driver. . . lark2S(7) 
Module Drive for VM21 Driver and VM22 Driver. . lark8(7) 
Mogules a3: 4s a ee Gee pcae cee oe ecaas cat t m4007) 
monacct, nulladm, prctmp, prdaily, prtacct, ..... acctsh(1M) 
monitor: prepare execution profile. . ....-2-. 26. monitor(3C) 
MOnitOr UWEp TET WOK. «. s--< Gs“e we Sd We Ayo aS . uusub(1M) 
moo: guessing game. 2... ee ee et te ee ee moo(6) 
mount-a. file System; <<. 4:4. & 5 4 6. 4s Sk es mount(2) 
mount and dismount filesystem. ......s.es+--. moun t(1M) 
mount: mounta filesystem. ...... ae eee mount(2) 
MOUNt ADEs Ss ge Shae de ew a iil eh /Salige oi . setmnt( 1M) 
mount, umount: mount and dismount file system. . . . mount(1M) 
mounted file system table. ...... . ee ee ~~ mnttabl(4) 
movea directory. ..... ae Sit ihc aa Se arse dg mvdir( 1M) 
MOVERS: “ete $4 eA hh a SS cp(1) 

move read/write file pointer. .....+.eeeees lseek(2) 
move requests. Ipsched, Ipshut, ......... ~~ Ipsched(1M) 
mrand48, jrand48, srand 48, seed 48, Icong 48: ate eos drand48(3C) 
msgctl: message contro] operations. ....-s.ee- msgctl(2) 
msgget: get message queue. .... 2. - wee es  msgget(2 
MSQTCV: message operations. . . 2... 2. 1 ee ee ee msgop( 2) 
msgsnd, msgrcv: message operations. .....---.- msgop( 2) 
mv:copy,. link or move files... 9.64 6 % oS % es cp(1) 

mvdir: move a directory. «2.4.45 e466 6% 46 mvdir( 1M) 
MVME400 Dual RS-232C Serial Port Module... .. m400(7) 
MVME410 line printer interface .. 2... 22 eee Ip(7) 

natural logarithm intrinsic function. ...-.«.-.see- log(3F) 
ncheck: generate names from i-numbers. ....... ncheck(1M) 
nearest integer functions. . ..... ee. 2... . round(3F) 
network useful with graphical commands. ..... . stat(1G) 
NETWORK a.” ae gt aso, ty va Me ce Se a oe ee el or USED M) 
newform: change the format of a text file. ...... newform(1) 
newgrp: log in toa new group. .........-.. newgrp(l 
news items. ...... one a caigh arid hv ae . ee ee 6news(l) 
news: print news items. .....+.+.2-+ee... news(l1) 
nice: change priority of a process. ......... . nice(2) 

nice: run a command at low priority. ........ nice(1) 
nint, idnint: FORTRAN nearest integer functions. . . . round(3F) 
nl: line numbering filter. ... 44. 4 e664 2% nl(1) 

nlist: get entries from name list... 1... 2-2 - ee nlist(3C) 
nm: print name list of common obpct fle ...... nm(1) 
nohup: run a command immune to hangups and quits. nohup(1) 
TION21OCAlCOLOz feck Ga sd Mo ee ie a, ae, at . . « setjmp(3C) 
not, Ishift, rshift: FORTRAN bitwise Boolean ... . . bool(3F) 
nrand48, mrand48, jrand48, srand48, seed48, ..... drand48(3C) 
MUGS, 42 a ae ee ats Si re, ete, Be cer ate ne ee Se OULD 
mul ithe mu) lessen 4s cS ge 4 ees ts Ace Boa ae BS null(7) 
nulladm, pretmp, prdaily, prtacct, runacct,/ ... . . acctsh(1M) 
Mumberog Hite. 4% 4 ane: awe ewe oe Se ae ws nl(1) 
numerical commands: 6°45 44. @ <a> G4 Se we ae graphics( 1G) 
object file access routines. . 1.6 1 ee ee ee ee ldfcn(4) 
obgct file converter, ........ 2? oa ae wc ORV 
objet file. ... 0.2.4, ee Oe ee ee ee dum p(1) 
object file for reading. ........6-62e+02- . Idopen(3X) © 
obpct file function. Idlread,ldlinit, ........ . Idlread(3X) 
Ob ect Ger cos hee we Gia ee a el oe eo ee es Idclose(3X) 
Obect Hl. Vora SiGe aa Se wee ee ee » Idfhread(3X) 
OCU Ale, 6. a ee ee BGA We Avs .... . Idgetname3X) 
ob pct file. Idiseek, Idniseek: seck .......... Idlseek(3X) 
obpct file. ldohseek: . 2... 2.0.0.6 664. ~~ Idohseek(3X) 
object file. Idrseek, Idnrseek: .......2. . « « Idrseek(3X) 
object file. Idshread, Idnshread: ....... . . . . Idshread(3X) 
object file. Idsseek, Idnsseek: 2. ....-..2-e6-. . Idsseek(3X) 
obget file. Idtbindex compute .......... . Idtbindex(3X) 
obpct file. Idtbread: 2-2. 6 eee ee eee ee idtbread(3X) 
obpct file. .... 5s lack. Gro ae uae Gee. Ss rata idtbseek(3X) 
ORE Glee go oe 4 Seas sitio wage a es vas a ane linenum(4) 
Ob pct Ales: & 4y4 Gd, oy & a we we wee ee nm) 
obpect file. . .....26..- ae ae 6 Wed wo reloc(4) 

OU BCU TIES. 4. su, an ee te oS Se ae we ee es Senhdr(4) 
obpet file. strip: 2 6 65 6 066s se ww es + Strip) 
obget file symbol table format. .......2.2..- syms(4) 
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filehdr: file header for common 

cpset: install 

Id: link editor for common 

size: print section sizes of common 

lorder: find ordering relation for an 

sky: 

getgrent, getgrpid, getyrnam, setgrent, endgrent: 
od: 


Idopen, Idaopen: 
fopen, freopen, fdopen: 
dup: duplicate an 
open: 


bo.macs: bootstrap 

bo.vme: bootstrap 

prf: 

prfid, prfstat, prfdc, prfsnap, prf pr: 

uname: get name of current 

memccpy, memchr, memcmp, memcpy, memset: memory 
msgctl: message control 

msgsnd, msgrcv: message 

ops.macs: EXORmacs 

semctl: semaphore control 

semop: semaphore 

shmctl: shared memory control 

shmat, shmdt: shared memory 

strrchr, strpbrk, strspn, strcspn, strtok: string 
pin: relational database 


dcopy: copy file systems for 

curses: CRT screen handling and 

getopt: get 

aouthdr: 

Idohseek: seek to the 

fentl: file control 

Stty: set the 

getopt: parse command 

Boolean functions. and, 

lorder: find 

mknod: make a directory, or a special or 
dial: establish an 

aout: common assembler and link editor 
vprintf, vfprintf, vsprintf: print formatted 
printf, fprintf, sprintf: print formatted 
commands. acctdisk, acctdusg, accton, acctwtm p: 
chown: change 

chown, chgrp: change 


curses: CRT screen handling and optimization 
sal, sa2, sadc: system activity report 

stdio: standard buffered input/output 

stdipe: standard interprocess communication 
4014: 

getperp, getppid: get process, process group, and 
getopt: 


getpw nam, setpwent, endpwent, fgetpwent: pet 
putpwent: write 

passw d: 

getpass: read a 

passwd: change login 

pwck, grpck: 

subsequent lines of one file. 

getcwd: get 

basename, dirname: deliver portions of 
grep, egrep, fgrep: search a file for a 
awk: 


pack, 

popen, 

your processor type. 
mesg: 

ptx: 
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Ob pct AlGSs: 4: 4oceatd Aw S74 Se She . 2» filehdr(4) 
object files in binary directories. .......-6.e- cpset(1M) 
obpct AIG: 4 & aw a4. 6 @ oo ae, GH oa) are ae LOD) 
obpct files. 2... ee eee ee eee ee size(1) 
obpct library. 2 6.46.4. ee oe SS Geteh ie an ee He » lorder(1) 
obtain ephemerides. 2... 2.202 6 ee ee ee © SKY6) 
Obtains, 4 shh aoe Shoo ee esa Ae He . ee e + getgrent(3C) 
Octal GUI Ps. 2 te- 6 ee eget Se SS od(1) 
odroctalGugips ya: 6.36 we a Re ee eS od(1) 

open a common obgct file for reading. .....--- Idopen(3X) 
Open: aStreains. 4.4 a eo eS) ease Se le el de SS fopen( 3S) 
open file descriptor, .... 2... se eee eevee dup(2) 
open for reading or writing. ......2... . « - open(2) 
open: open for reading or writing. . . ...... =. open(2) 
operating procedure for system restart on EXORmacs. . bo.macs(8) 
operating procedure for system restart on VME/10. . . bo.vme(8) 
operating system profiler. ....... ee ee ee, 
operating system profiler. ....... ss acR Soh stk das os profiler(1M) 
operating system. ......... Bs Jase aigcas 2 a uname(2) 
QDETStiONS.- 6. <p: -iey sana Geog ae Ss es ee Ss . memory(3C) 
ra) 02) 16 (0) a a oe an eee a me . » msgcti(2) 
OPCTATONS:.. i. dus See BS oe ow eae » msgop(2) 
OpeTAtlONSs Kai 4: tw, Ai Aiea ee Sa oe ee ee + 6 Opsmacs(8) 
operations. ... 2.2 eee ee eee ge! ah Whey semctl(2) 
OpeTaHONSs “4-K Gada) Shea ene ee St es semop(2) 
Operations: “a. d.4. wee dae RA a ee es . shmeti(2) 
OPCTALIONSS. GK Bisse: Bok eh tes See. we ee: wae, S shmop(2) 
operations. /strcpy, strncpy, oo strchr, .... . . string(3C) 
Gperators acai gk ace es SS em es eee pin() 
ops.macs: EXORmacs operations. ea ee ee ee ops.macs(8 ) 
optimal access time. 2... 1.22 es eee eee . « dcopy(1M) 
optimization packagee ........-- we ee © © curses(3X) 
option letter from argument vector. ......... getopt(3C) 
optional aout header. . 2.2.2... - eee » . « « « aouthdr(4) 
optional file header of a common obgct file. . .. . . Idohseek(3X) 
OPCON Ses 225 92 SS Shae ag a eR ALS! SS fentl(S) 
options fora terminal. .......+-22e-2ee0. . « stty(1) 
OPHONS! <e. wie a Gi ce Ae eh koh eens. Sos a petopt) 
or, xor, not, Ishift, rshift: FORTRAN bitwise ..... bool( 3F) 
ordering relation for an object library. . ..... «© lorder(1) 
ordinary fla ........ be lent Se thas eae de ee mknod(2) 
out-going terminal line connection. ....... . . dial(3C) 
Olt pts acs: eee go. L.A ee ee ee a.out(4) 
output of a varargs argument list. .........-- vprintf(3S) 
output. ...... Bie Tasteen 2 Surat tan ee Peale . . - printf(3S) 
overview of accounting and miscellaneous accounting . acct(1M) 
owner and group ofa file. ..... 2-2-2000. chow n(2) 
owner or group. ...... wee ee ee we ~ Chown(1) 
pack, pcat, un pack: compress and expand files. ... . pack(1) 
package. .......-: we chads co a 84 » + + « curses(3X) 
PACKAGe.. see ca ge Sh Se Bets as a oat Re gta bos sar(1M) 
package .. 2... ee ee tar 8 ee ee stdio(3S) 
PACKAQe.: 36. oe. Sie, hk er Os Se et Sm, wee . . stdipc(3C) 
paginator for the Tektronix 4014 terminal. ...... 401401) 
parent process IDs. getpid, .......-2-2see- getpid(2) 
parse command option. ......-.4-.6-+-2se6-. getopt(1) 
passwd: change login password. ........-.--. passwd(1) 
passwd: password fle ....... 262264... passwd(4) 
password file entry. getpwent, petpwuid, ..... . getpwent(3C) 
password fileentry. .....+..-2ee+e+.s.-. + putpwent(3C) 
password file. ......-220+002ee0e244.4.. passwd(4) 
password. ..... shia “Sie Hae, BS ode Saha a Teh ah ae, do PRE PASSE SO) 
password. 2... 2.2. ee ee eee ee ee ew ee © passwd) 
password/group file checkers. .......- . . » pwek(1M) 
paste: merge same lines of several filesor ....... paste(1) 
pathname of current working directory. ....... getcwd(3C) 
pathnames. ... 20.2.2 ee eee ee ee ew ee © Dasename1) 
pattern. ..... gripe aye. ate, Gre nana as See, grep(i) 
pattern scanning and processing language. ...... aw k(1) 
pause: suspend process until signal. . ......-. . pause(2) 
peat, unpack: compress and expand files. ...... . pack(1) 
pelose: initiate pipe to/from a process. ...... . . popen(3S) 
pdp11, u3b, vax, m68k: provide truth value about . . machid(1) 
permit or deny messages. ......2002022-28- 1) 
permuted index. ... 2.222502 eee ee oe « ptx(l) 
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acct: 

acctcms: command summary from 
messages. 

pg: file 


split: split a file into 


tee: 
popen, pclose: initiate 


fseek, rewind, ftell: reposition a file 
lseek: move read/write file 


m400: MVME400 Dual RS-232C Serial 

ar: archive and library maintainer for 

basename, dirname: deliver 

dim, ddim, idim: 
banner: make 

_ root functions. exp, log, 1og10, 

exp, (ee: log10, pow, sqrt: exponential, logarithm, 
bre, bcheckre, re, 


/ckpacct, dodisk, lastlogin, monacct, nulladm, 
/dodisk, lastlogin, monacct, nulladm, prctmp, 
dprod: double 

monitor: 

_ cpp: the C language 

unget: undo a 


prfid, prfstat, 

system profiler. 

prfid, prfstat, prfdc, prfsnap, 
prfid, prfstat, prfdc, 

profiler. prfid, 


gps: graphical | 


types: 
prs: 
date: 


sact: 

man, manprog: 

cat: concatenate and 

pr: 

vprintf, vfprintf, vsprintf: 
printf, fprintf, sprintf: 

I pstat: 

- mm: 

uname: 

news: 

acctcom: search and 

size: 

id: 

Ipd: line 

lp: MVME410 line 

lp, cancel: send/cancel requests to an LP line 
enable, disable: enable/disable LP 


nice run a command at low 

nice change 

errpt: 

acct: enable or disable 

acctprel, acctprc2: 

acctcom: search and print 

times: get 

init, telinit: 

timex: time a command; report 

exit, exit: terminate 

fork: create a new 

getpid, getpgrp, getppid: get process, 
setpgrp: set 

getppid: get process, process group, and parent 


process group ID. 


per-process accounting file format. . . 
per-process accounting records. ee ee ae oe eae 
perror, errno, sys_errlist, sys_perr: system error ... . 
perusal filter for soft-copy terminals. 
py: file perusal filter for soft-copy terminals. ..... 
pieces. .... 
pipe: create an interprocess channel. 
pipe fitting. 
pipe to/from a process. 
plock: lock process, text, or data in memory. 
plot: graphics interface .. 
plot: graphics interface subroutines. 
pnch: file format for card images. 

pointer in astream. ... 
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popen, pclose: initiate pipe to/from a , process. 
Port Module. 
portable archives. 
portions of pathnames. 
positive difference intrinsic functions. 
posters. 
pow, sqrt: exponential, logarithm, power, square .. 
power, square root functions. . 
powerfail: system initialization shell scripts. 
pr: print files. 
prctmp, prdaily, prtacct, runacct, shu tacct,/ 
prdaily, prtacct, runacct, shutacct, startup,/ 
precision product intrinsic function. 
prepare execution profile. 
preprocessor. 
previous get of an SCCS file. 
prf: operating system profiler. .... 
prfdc, prfsnap, prfpr: operating system profiler. 
prfid, prfstat, prfdc, prfsnap, prfpr: operating . 

prfpr: operating system profiler. 
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prfsnap, prfpr: operating system profiler. .... 
prfstat, prfdc, prfsnap, prfpr: operating system . 
primitive string, format of graphical files. . 
primitive system data types. A 
print an SCCS file. : 
print and set the date. . 
print calendar. .... 
print checksum and block count of a file. 
print current SCCS file editing activity. 
print entries in this manual. ... 
print files. . 2... ee we eevee 
print files. 
print formatted output of a varargs argument li 
print formatted output. 
print LP status information. 
print name list of common obpet file. ....... 
print name of current UNIX System. ....... 
print news items. .... 
print process accounting files. ..... 
print section sizes of common obpct files. . ...... 
print user and group IDs and names. . . 
printer daemon. 

printer interface. 
printer. .. 
printers, 2. 2. ee eee eee cee wens 

printf, fprintf, sprintf: print formatted output. 
priority. 
priority of a process. 
process a report of logged errors. ..... 
process accounting. 
process accounting. 
process accounting file(s. . 
process and child process times. . 
process control initialization. . . 
process data and system activity. 

process. .. 
process. . 2... 2 oe ee ee 
process group, and parent process IDs. . . 
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acct(4) 
acctems( 1M) 


pr(1) 
acctsh(1M) 
acctsh(1M) 
dprod(3F) 
monitor(3C) 


profiler(1M) 
profiler(1M) 
profiler(1M) 
profiler(1M) 
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wee ee ss inittab(4) 
.... kW) 
... nice(2) 
.... kill(2) 


inittab: script for the init process. ....... ae te er ee ae 
kill: terminate a process. .... 2. ee ee ee 

nice: change priority of a process. . .. 2... 2. eee 
kill: send a signal to a_ process or a group of processes. 
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popen, pclose: initiate pipe to/from a process. ...... er ee ae } . + . popen(3S) 
getpid, getperp, getppid: get process, process group, and parent process IDs. . + « getpid(2) 
ps: report process status. ........ tie ania Tae 0s » . - ps(l) 
plock: lock process, text,or datain memory. ......e+-e-. plock(2) 
times: get process and child process times. ........+.2.-. we ee ee es times(2) 
Wait: wait for child process to stop or terminate. ......-seeeeee wait(2) 
ptrace: process trace. . 2... ee ee eee ee te wes . . ptrace(2) 
pause: suspend process until signal. . 2... 2. eee eee eee pause(2) 


Wait: await completion of process. . .. 2.6 ee ee ee ee ee ee es Wwait(l) 
checklist: list of file systems processed by fsck. ......-0.00-6 . . «+ checklist(4) 

kill: send a signal to a process or a group of processes. . 2... 2 eee ee ee ee we ee ew we Kill) 
killall: kill all active processes. . 2... 22 eee ee eee . . » . killall(1M) 


fuser: identify processes using a file or file structure. 2 2 ee ss © fuser(1M) 
awk: pattern scanning and processing language... 2... ee. ee eee eee awk(1) 
shutdown: terminate all processing. ........ ee Or Wi SP ENS shutdown(1M) 
mailx: interactive message processing system. ........-0-¢ ws ee ee mailx(1) 
m4: macro processor, .... 2... by Sak we, Rat eeeets 2... m4) 
u3b, vax, m68k: provide truth value about your processor type. pdpll, .....-.+ eee . + +» machid(1) 
wffmt: format floppies for the VME/10 processor. ..... pie Ke la, Od By Zee, toe wae ae WELD 
fscv: convert files between M68000 and VAX-11/780 processors. .......06. or tes Beh. esd wea: ace SEV 
alarm: set a process’s alarm clock. ...... See Gi de. eS, 16 ere Alarm) 
dprod: double precision product intrinsic function. ........ +e... dprod(3F) 
prof: display profile data. ...... ee ee eee » prof(1) 
prof: profile within a function. ........... prof(S) 
profil: execution time profile. ............ profil(2) 
prof: display profiledata. .........2-26-+e0- we ee e + prof(l) 
monitor: prepare execution profile. .......-2.0ee00- sv a eis ee a aso MOMItOFEAC) 
profil: execution time profile. ........20+62c-08e80808-8 wee ee es profil(2) 
profile: setting up an environment at login time. .. . profile(4) 
prof: profile within a function. .........- . + « « prof(S) 
prf: operating system profiler. .... a ee ee ee ae ae aS. prt) 
prfstat, prfdc, prfsnap, prfpr: operating system profiler. prfid, ........... we ee ee es 6profiler(iM) 
sadp: disk access profiler, ......... a ee ee eee . . sadp(1) 
sh, rsh: shell, the standard/restricted command programming language ......-2 2+ eee ees sh(1) | 
arithmetic: provide drill in number facts. . . 2... 2 eee . arithmetic(6) 
pdp11, u3b, vax, m68k: provide truth value about your processor type... . machid(1) 
true, false: provide truth values. . 2... 2... eee ee wees true) 
prs: print an SOCS file. .........0.6-. ~ . . s prs(l) 
/lastlogin, monacct, nulladm, prctmp, prdaily, prtacct, runacct, shutacct, startup, turnacct:/ ..... acctsh(1M) 
pS: report process status. ...... be ede St ta Porn . ps(1) 
sxt: pseudo-device driver. . . 1... 2 eee eee eee sxt(7) 
seed.48, lcong48: generate uniformly distributed pseudo-random numbers. /mrand48, jrand48, srand48, drand48(3C) 
ptrace: process trace. .......- gh Soa de isis Soe dy ptrace(2) 
ptx: permuted index. ........ eee se ptx(1) 
ungetc: push character back into input stream. ...... . . ungetc(3S) 


on a stream. putc, putchar, fputc, putw: put character or word . . putc(3S) 
stream. putc, putchar, fputc, putw: put character or word ona .. . putc(3S) 
putenv: change or add value to environment. ... . . putenv(3C) 
putpwent: write password fileentry. ........ putpwent(3C) 
puts, fputs: put a string on astream.......... puts(3S) 
utmp file entry. getutent, getutid, getutline, pututline, setutent, endutent, utmpname: access .. . getut(3C) 
putc, putchar, fputc, putw: put character or word on astream. .... . . putc(3S) 
pwck, grpck: password/group file checkers. . .... . pwek(1M) 
pwd: working directoryname. ........... pwd(l) 
qsort: quicker sort. . . 2. 2 ee ee ee ew ee ee © Qsort(3C) 
tput: query terminfo database ...... 5.062422... tput(l) 
msgpet: get message queue. ... 2... 2 ee ee eee ee ew ee ee  msppet(2) 
ipcrm: remove a message queue, semaphore set or shared memory id. . ... . . iperm(1) 


qsort: quickersort. .. 2... 2.22 eee dae fas, Oe See ee qsort(3C) 

nohup: run a command immune to hangupsand quits. ......... re ee a a oe ee oe ee ee nohup(1) 

quiz: test your knowledge. 2... 6 2 2 ee ee ee quiz(6) 

irand,srand, rand: random number generator. .....-+-2-2-e-s rand(3F) 

rand, srand: simple random-number generator. ... . rand(3C) 

irand, srand, rand: random number generator. ......-..-:.-. ~~. rand(3F) 

rand, srand: simple random-number generator. .......-0-0e06-. rand(3C) 

fsplit: split £77, ratfor, or efl files. .......2.. Aas See, Ae-8 fsplit(1) 

ratfor: rational FORTRAN dialect. .....-....-. ratfor(1) 

ratfor: rational FORTRANdialect. ............. ratfor(1) 

brc, bcheckrc, rc, powerfail: system initialization shell scripts. . . . . bre(1M) 
getpass: read a password. .. 2... ee ee ee ee wees getpass(3C) 


obpet file. Idtbread: read an indexed symbol table entry of acommon . . . Idtbread(3X) 
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ob pct file. Idshread, ldnsh read: 
read: 

mail, rmail: send mail to users or 
line: 


file. Idahread: 

Idfhread: 

Idopen, Idaopen: open a common ob¢ct file for 
open: open for 

lseek: move 

char: explicit FORTRAN type/ int, ifix, idint, 
malloc, free, 

memory allocator. malloc, free, 

signal: specify what to do upon 

signal: specify FORTRAN action on 

command summary from per-process accounting 
| errdead: extract error 

fwtmp, wtmpfix manipulate connect accounting 
frec: 

ed, 

expression. 


make: maintain, update, and 
regemp, 

routines. 

regexp: 

regcmp: 

regemp, regex compile and execute a 
accept, 

comm: select or 

lorder: find ordering 

pin: 

file. 

file. ldrseek, ldnrseek: seek to 
reloc: 

floor, ceil, fmod, fabs: floor, ceiling, 
mod, amod, dmod: FORTRAN 
mk: how to 

calendar: 

ct: spawn getty toa 

rm del: 

memory id. ipcrm: 

unlink: 

rm, rmdir: 

file system consistency check and interactive 
unig: report 

Tjestat: RJE status 

clock: 

Status. ipcs: 

df: 

€rrpt: process a 

sal, sa2, sade: system activity 
timex time a command; 


ps: 


uniq: 


trenter: enter a trouble 

sar: system activity 

fseek, rewind, ftell: 

Ipsched, Ipshut, lpmove: start/stop the LP 
accept, reject: allow/prevent LP 

start/stop the LP request scheduler and move 

lp, cancel: send/cancel 

bo.macs: bootstrap operating procedure for system 
bo.vme: bootstrap operating procedure for system 
idgetname: 

getarg: 

getenv: 

mclock: 

abs: 

len: 

index: 

logname: 

getenv: 

Stat: data 

reversi: a game of dramatic 


read an indexed/named section header of acommon . . Idshread(3X) 
read from fle. . 2... ee ee eee ee ee ww we  TeAd(2) 
VAG Maile. e 4. 4 vies: Se wae ee a ee, ee GS ome) 
Teac ONG lines, 46.6 hw eS ee Sw es ew eee ee lined) 
read: read from file... 2.2 eee ee we oe oe © © Tead2) 
read the archive header of a member of an archive . . Idahread(3X) 
read the file header of a common obfect file. ... . . Idfhread(3X) 
reading. ..... sls R pare ee tates . eee « ~ Idopen(3X) 
reading or writing. ......... wee ee ee © Open(2) 
read/write file pointer, Be she Stee oe es Ble ede as, S0-s 2IS OOK) 
real, float, sngl, dble, cmplx, demp}x, ichar, ee ae ftype(3F) 
realloc, calloc: main memory allocator. . . .... . . malloc(3C) 
realloc, calloc, mallopt, mallinfo: fast main .... . . malloc(3X) 
receipt of asignal. . 2... 6.6.50 ee ee ee es Signal) 
receipt of asystem signalh ............. Signal(3F) 
records. acctcms: .... 2. eee eee ee © © © acctcms( 1M) 
recordsfrom dump. .......2.2.+-e-eee-e errdead(1M) 
POCOrdS:: 6" wd sxe <e, Bob. el SE. ene hw 2 > wep M) 
recover files from a backup tape. ........ .. frec(1M 
red: texteditor. 2... eee eee ee eee ee © CM) 
regemp, repex compile and execute a regular oe ee  Tegemp3X) 
regemp: regular expression compile. ....... . . repemp(1) 
regenerate groups of programs. ........... makeél) 
regex: compile and execute a regular expression. . . . . regcmp(3X) 
regexp: regular expression compile and match .... . regexp(S) 
regular expression compile and match routines. . . . . regexp(S) 
regular expression compile. ........ oe ee» regemp(l) 
regular expression. . 2... 2 1 ee ee ee ew ew © FEgemp(3X) 
rect: allow/prevent LP requests. ..... se » accept(l 
reject lines common to two sorted files. ....... comm(1) 
relation for an obgcet library. . ...... . « « « » lorder(1) 
relational database operator. ...... wee eee pint) 
reloc: relocation information for acommon obgct .. . reloc(4) 
relocation entries of a section of acommon object . . . Idrseek(3X) 
relocation information for a common obpct file. . . . . reloc(4) 
remainder, absolute value functions. ...... . . « floor(3M) 
remaindering intrinsic functions. .......... mod(3F) 
remake the system and commands. ......... mk(8) 
reminder service. . 2... eee eee ee ee ee se Calendar(1) 
TeMmOte VerMinale. Boke 6. we See Se BOC es . ctC) 
remove a delta from an SCCS file. .......... rmdel(1) 
remove a message queue, semaphore set or shared . . . iperm(1) 
remove directory entry. .....2...s..s-e+... unlinkQ) 
remove files or directories. ........e.+e.... rm(1) 
repair. fsck,dfsck: . . . 2. eee ee ee ew ee © fsck(1M) 
repeated linesina file. . 2... 2.20502 ee eee © Unig(1) 
report and interactive status console... ..... . . rjestat(1C) 
report CPU time used. . 2... 660 ee eee ee © Chock(3C) 
report inter-process communication facilitie® ase. ics o ipes(1) 
report number of free disk blocks. ....... » . » dfC1M) 
report of logged errors. . 2... ee ee ee ee ee errpt(1M) 
report package. 2. 2 ee ee eee ee we ee es SAM IM) 
report process data and system activity. ......-. timex(1) 
report process status. . 2... eee eee ee wwe ps(1) 

report repeated lines ina file ........ » + 6 « unig(1) 
TOOOIG. 40 626.8) sw Go RR Eee Se Me . . . . trenter(1M) 
reporter. ....... fc 1B 0 Gro, Ge, -e ca-S re Je Be SOT) 
reposition a file pointer in a stream. ....... . . fseek(3S) 
request scheduler and move requests. ...... ~~ Ipsched(1M) 
requests. 6. 6 6 ee ee ee eee we ww ww ow © accept( 1M) 
requests. Ipsched, lpshut, lpmove ........ ~~ Ipsched(1M) 
requests to an LP line printer. ....... 4 ae dpe) 
restart on EXORmacs. . 2... 2.25 ee ee eevee bo.macs(8) 
restarton VME/10. ........6-6.2-+2-24 4. bovme8) 
retrieve symbol name for obgct file. ....... =. . Idgetname3X) 
return FORTRANcommand-line argument. ... . . getarg(3F) 
return FORTRANenvironment variable ...... . getenv(3F) 
return FORTRANtime accounting. ....... . . melock(3F) 
return inteper absolute value .......-.. «© © abs(3C) 
return length of FORTRANSstring. ........ . len(3F) 
return location of FORTRANsubstring. ..... . . index(3F) 
return login name of user. .......-62-20-6- lopname(3X) 
return value for environment name. ......... getenv(3C) 
returned by stat system call. So ene eae at ES we UALS) 
reversals. . 2... ee ey eee ee ee ee ee reversi(6) 


col: filter 


stream. fseek, 

creat: create a new file or 
rjestat: 

console. 


mail, 


m, 
chroot: change 
chroot: change 

pow, sqrt: exponential, logarithm, power, square 
sqrt, dsqrt, csqrt: FORTRAN square 

hpd, erase, hardcopy, tekset, td: graphical device 
ldfcn: common obfct file access 

regexp: regular expression compile and match 
toc: graphical table of contents 

m400: MVME400 Dual 

programming language. sh, 

and, or, xor, not, lshift, 

nice: 

nohup: 

runacct: 


/monacct, nulladm, pretmp, prdaily, prtacct, 


sal, 

Driver. 

Winchester Disk Driver. 
Driver. 

Driver. 


sal, sa2, 


ork, 


bfs: big file 
awk: pattern 


cdc: change the delta commentary of an 
com b: combine 

delta: make a delta (change) to an 
Sact: print current 

get: get a version of an 

prs: print an 

rmdel: remove a delta from an 
sccsdiff: com pare two versions of an 
secsfile: format of 

unget: undo a previous get of an 
val: validate 

admin: create and administer 

what: identify 


Ipsched, Ipshut, Ipmove: start/stop the LP request 


curses: CRT 

ex. Vi: 

inittab: 

rc, powerfail: system initialization shell 


grep, egrep, fgrep: 

acctcom: 

lsearch, lfind: linear 

bsearch: binary 

hsearch, hcreate, hdestroy: manage hash 

tsearch, tfind,  tdelete, twalk: manage binary 
ptto: 

scnhdr: 

ldshread, Idnshread: read an indexed/named 
idiseek, Ildnlseek: seek to line number entries of a 


reverse line feeds. 2... ee eee ee ee ee ns col(1) 
reversi: a game of dramatic reversals. ...... . . reversi(6) 
rewind, ftell: reposition a file pointerina .... fseek(3S) 
rewrite an existing one. .......++++e+e.. creat(2) 
RJE status report and interactive status console. .. . rjestat(1C) 
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ldrseek, ldnrseek: seek to relocation entries of a 
Idsseek, Idnsseek: seek to an indexed/named 
size: print 


/\rand48, nrand48, mrand48, jrand48, srand48, 
obgct file. Idsseek, ldnsseek: 
common ob¢gct file. ldlseek, ldniseek: 
obpect file. Idrseek, ldnrseek: 

file. 1dohseek: 

Idtbseek: 

shmget: get shared memory 

brk, sbrk: change data 

comm: 

greek: 

cut: cut out 

dump: dump 

semctl: 

semop: 

ipcrm: remove a message queue, 

sem get: get set of 


kill: 

mail, rmail: 

Ip, cancel: 

m400: MVME400 Dual RS-232C 


setuid, 
getprent, getgrgid, getgrnam, 


entry. getpwent, getpw uid, getpwnam, 
profile: 
gettydefs: speed and terminal 


entry. getutent, getutid, getutline, pututline, 
setbuf, 

independent fashion... sputl, 

program ming language. 

shmctl: 

ipcrm: remove a message queue, semaphore set or 
shmat, shmdt: 

shm get: get 

system: issue a 

system: issue a 

shl: 

prtacct, runacct, shutacct, startup, turnacct: 

orc, bcheckrc, rc, powerfail: system initialization 
: - language. sh, rsh: 


shmat, 
/nulladm, prctmp, prdaily, prtacct, runacct, 


sdiff: 

intrinsic function. 

login: 

pause: suspend process until 

signal: specify what to do upon receipt of a 
specify FORTRAN action on receipt of a system 
system signal. 

signal 


kill: send a 

ssignal, gsignal: software 
lex: generate programs for 
rand, srand: 
trigonometric functions. 


sin, dsin, csin: FORTRAN 
sinh, dsinh: FORTRAN hyperbolic 
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seek to line number entries of asectionofa ... 
seek to relocation entries of a section of a common 
seek to the optional file header of a common obfct 
seek to the symbol table of a common obegct file. . . 
segment. 
segment space allocation. tee, aa 
select or refct lines common to two sorted files. 
select terminal filter. . . 2... 2.2 
selected fields of each lineofa file ... 
selected parts of an obpct file ...... 
semaphore control operations. ...... 
semaphore operations. 
semaphore set or shared memory id. ....... 
semaphores. 
semctl: semaphore control operations. ...... 
semget: get set of semaphores. . . . 2. 2 2. 2 ee 
semop: semaphore operations. gee at 
send a signal to a process or a group of processes. . 
send mail to users or read mail. . . 2... «62 ee 
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send/cancel requests to an LP line printer. ... 
Serial Port Module... ; 
setbuf, setvbuf: assign buffering toa stream. ... . 
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setgid: set user and group IDs. 
setgrent, endgrent: obtain. 
setjmp, longjmp: non-local goto. 
setmnt: establish mount table. . 
setpgrp: set process group ID. . . 
setpwent, endpwent, fgetpwent: get password file 
setting up an environment at login time. 
settings used by getty. 
setuid, setgid: set user and group IDs. 
setutent, endutent, utmpname: access utmp file 
setvbuf: assign buffering to a stream. 
sgetl: access long integer data in a machine . . 
sh, rsh: shell, the standard/restricted command 
shared memory control operations. . . 
shared memory id. 
shared memory operations. 
shared memory segment. 

shell command from FORTRAN . 
shell command. 
shell layer manager. . 
shell procedures for accounting. /prctm p, prdaily, : 
shell scripts. 
shell, the standard/restricted command programming 
shl: shell layer manager. 
shmat, shmdt: shared memory operations. . 
shmctl: shared memory control operations. . 
shmdt: shared memory operations. .... . 
shm get: get shared memory segment. 
shutacct, startup, turnacct: shell procedures for/ 
shutdown: terminate all processing. 
side-by-side difference program. 
sign, isign, dsign: FORTRAN transfer-of-sign . 
SIPN ON. «2 eee ee we ee eee eens 
signal. 
signal. 
signal. signal: 
signal: specify FORTRAN action on receipt of a 
signal: specify what to do upon receipt of a 

signal to a process or a group of processes. . 
Signals, 2... 2 we ee eee eee eens 
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simple random-number generator. .... 
sin, cos, tan, asin, acos, atan, atan2: 
sin, dsin, csin: FORTRAN sine intrinsic function. 
sine intrinsic function. 
sine intrinsic function. . 2... +. +e see eee 
sinh, cosh, tanh: hyperbolic functions. 
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ldrseek(3X) 
Idsseek(3X) 
size(1) 
sed(1) 
drand48(3C) 
Idsseek(3X) 
Idlseek(3X) 
ldrseek(3X) 
Idohseek(3X) 
ldtbseek(3X) 
shm get(2) 
brk@) 


~» comm(1) 


greek(1) 
cut(1) 
dum p(1) 
semctl(2)) 
semop(2) 


. iperm(1) 


sem get(2) 
semctl(2) 
sem get(2) 
semop(2) 
kill(2) 
mail(1) 
Ip(1) 


. m400(7) 
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setbuf(3S) 
setu aa ; 
getgrent(3C 
set jm p(3C) 
setm nt( 1M) 
setperp(2) 


. getpwent(3C) 


profile(4) 
gettydefs(4) 
setuid(2) 
getut(3C) 
setbuf(3S) 
sputl(3X) 
sh(1) 
shmctl(2) 
ipcrm(1) 
shmop(2) 
shmget(2) 
system(3F) 
system(3S) 
shi(1) 
acctsh(1M) 
bre(1M) 
sh(1) 

shi(1) 
shmop(2) 
shmcti(2) 
shmop(2) 
shm get(2) 
acctsh(1M) 
shutdown(1M) 
sdiff(1) 
sign(3F) 
login(1) 
pause(2) 
signal(2) 
signal(3F) 
signal(3F) 
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ssignal(3C) 
lex(1) 
rand(3C) 
trig(3M) 
sin(3F) 
sin(3F) 
sinh (3F) 
sinh(3M) 


function. 


size: print section 


ttyslot: find the 
spline: interpolate 
FORTRAN type/ int, ifix, idint, real, float, 


sno: 

pg: file perusal filter for 
ssignal, gsignal: 

sort: 

qsort: quicker 


tsort: topological 

comm: select or reject lines common to two 
brk, sbrk: change data segment 

ct: 

fspec: format 

signal. signal: 

signal: 

getty: set terminal type, modes, 
gettydefs: 

errors. 

spell, hashmake, 

spell, hashmake, spellin, hashcheck: find 


split: 
csplit: context 
fsplit: 


uuclean: uucp 

Ipadmin: configure the LP 

printf, fprintf, 

independent fashion.. 

function. 

functions. exp, log, log10, pow, 

log 10, pow, sqrt: exponential, logarithm, power, 
sqrt, dsqrt, csqrt: FORTRAN 

irand, 

rand, 

/erand 48, lrand48, nrand48, mrand48, jrand48, 
scanf, fscanf, 


scc: C compiler for 

stdio: 

stdipc: 

sh, rsh: shell, the 

requests. Ipsched, Ipshut, lpmove: 
/prctmp, prdaily, prtacct, runacct, shutacct, 


commands. 

stat: data returned by 

Stat: 

ff: list filenames and 

ustat: get file system 

rjyestat: RJE status report and interactive 
Ipstat: print LP 

ferror, feof, clearerr, fileno: stream 
uustat: uucp 

ipcs: report inter-process communication facilities 
ps: report process 

rjestat: RJE 

Stat, fstat: get file 


package. 


wait: wait for child process to 

strlen, strchr, strrchr, strpbrk, strspn, strcspn,/ 
/strncat, strcmp, strncmp, strcpy, strncpy, strien, 
strrchr, strpbrk, strspn,/ strcat, strncat, 

strspn, strespn,/ strcat, strncat, strcmp, strncmp, 
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sinh, dsinh: FORTRAN hyperbolic sine intrinsic . . . . sinh(3F) 
size: print section sizes of common obfct files. ... . size(1) 
sizes of common obfet files. ........06.062.. Siz&1) 
sky: obtain ephemerides. ........66-. 2 +. . Sky(6) 
sleep: suspend execution for an interval. ...... . sleep(1) 


sleep: suspend execution for interval. .....-.-e+.. 
slot in the utmp file of the current user. ..... 


sleep(3C) 
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specify FORTRAN action on receipt of a system - . . signal(3F) 
specify what to do upon receipt of asignal. .... . signal(2) 
speed, and line discipline. ........ os ee es getty(1M) 
speed and terminal settings used by getty. ...... per ietw a) 
spell, hashmake, spellin, hashcheck: find spelling ~. . . spell(1) 
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spelling errors. ..... clay We be ee Be ed: a Spell) 
spline: interpolate smooth curva ......ee8. spline(1G) 
split a fileinto pieces. ......662626ee.. Split(1) 
Splits. aS) eo wy wea eee i eee eee Ab eee tee ee SDI) 
split 77, ratfor, or ef] files. .. 2... 60s. es. fsplit(l) 
split: split a file into pieces. . 2... 1.6... split(l) 


spool directory clean-up. .......2- . es. . wuclean(1M) 
spooling system. .....6..606. er ae ee lpadmin(1M) 
sprintf: print formatted output. . ...... +... . printf(3S) 
sputl, sgetl: access long integer data in a machine .. . sputl(3X) 
sqrt, dsqrt, csqrt: FORTRAN square root intrinsic . . . sgqrt(3F) 
sqrt: exponential, logarithm, power, square root . .. . exp(3M) 
square root functions. exp, log, .......s.«.«-. exp(3M) 
square root intrinsic function. . . ........«. . sqrt(3F) 
srand, rand: random number generator. ...... . rand(3F) 
srand: simple random-number generator. . ..... . rand(3C) 
srand48, seed 48, lcong48: generate uniformly/ ... . drand48(3C) 
sscanf: convert formatted input. .......... . scanf(3S) 


ssignal, gsignal: software signals. 
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stand-alone programs. .....-.-2e--- 22+ ~ sect) 
standard buffered input/output package. .....-... stdio(3S) 
standard interprocess communication package. ... . stdipc(3C) 
standard/restricted command programming language. . sh(1) 
start/stop the LP request scheduler and move . ... . Ipsched(1M) 
startup, turnacct: shell procedures for accounting. . . . acctsh(1M) 
stat: data returned by stat system call. ........ stat(S) 
stat, fstat: get file status. .........4.e62.. Stat(2) 
stat: statistical network useful with graphical ... . stat(1G) 
stat system call. ...... i ee Ge Se, wah cha? Ua SAD) 
statistical network useful with graphical commands. . stat(1G) 
statistics for a filesystem. ..... +2 e+ eee. ffUIM 
Statistics: ¢: 22 HS a GS See Sw eee Soe oo USD) 
status console. 2 6 6 we ee ee ee ee ww ow ew fs Fepestat(1C) 
status information. ...... +. «.2 se «eee Ipstat(l) 
Status inGUifies.. <0) 4.42% SNCS SLI SS & ow eS ferror( 3S) 
status inquiry and pbcontrol. ......2.-226. uustat(1C) 


Status. 
status. 
status report and interactive status console. ...... 
status, 
stdio: standard buffered input/output package. nae ese 
stdipe: standard interprocess communication ..... 
stime: set time. 
stop or terminate. .. 
strcat, strncat, strcmp, strncmp, strcpy, strncpy, -.- . 
strchr, strrchr, strpbrk, strspn, strcspn, strtok:/ .... 
strcmp, strncmp, strcpy, strncpy, strlen, strchr, ... . 
strcpy, strncpy, strlen, strchr, strrchr, strpbrk, ... . 
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strncpy, strlen, strchr, strrchr, strpbrk, strspn, 


fclose, flush: close or flush a 

fopen, freopen, fdopen: open a 

rewind, ftell: reposition a file pointer in a 
getchar, fgetc, petw: get character or word from 
gets, fgets: get a string from a 

putchar, fputc, putw: put character or word on a 
puts, fputs: put a string on a 

setbuf, setvbuf: assign buffering to a 

ferror, feof, clearerr, fileno: 

ungetc: push character back into input 

convert between long integer and base-64 ASCII 
lge, Igt, lle, lt: 

gmtime, asctime, tzset: convert date and time to 
ecvt, fevt, gcevt: convert floating-point number to 
gps: graphical primitive 

gets, fgets: get a 

len: return length of FORTRAN 

puts, fputs: put a 

strchr, strrchr, strpbrk, strspn, strcspn, strtok: 
strtod, atof: convert 

atof: convert ASCII 

strtol, atol, atol: convert 

from an obpct file. 

obpect file. strip: 

strcat, strncat, strcmp, strncmp, strepy, strncpy, 
strchr, strrchr, strpbrk, strspn, strcspn,/ strcat, 
strpbrk, strspn, strcspn,/ strcat, strncat, strcmp, 
strcspn,/ strcat, strncat, strcmp, strncmp, strcpy, 
strncmp, strcpy, strncpy, strlen, strchr, strrchr, 

_ /stremp, strncmp, strcpy, strncpy, strlen, strchr, 
/strepy, strnepy, strlen, strchr, strrchr, strpbrk, 
number. 

strlen, strchs, strrchr, strpbrk, strspn, strcspn, 


fuser: identify processes using a file or file 


intro: introduction to 

plot: graphics interface 

paste: merge same lines of several files or 
index: return location of FORTRAN 
v1l0graph - VME/10 graphics 


du: 

acctcms: command 

sync: update the 

sync: update 

su: become 

ud: general driver for all disk units 

vm21: default general driver for all disk units 
vm22: default general driver for all disk units 
sleep: 

sleep: 

pause: 


swab: 


file. strip: strip 

ldgetname. retrieve 

ldtbindex: compute the index of a 
idtbread: read an indexed 

syms: common obfet file 
ldtbseek: seek to the 

sdb: 


perror, errno, 

perror, errno, sys_errlist, 

uuto, uupick: public UNIX 

ldtbindex: compute the index of a symbol 
ldtbread: read an indexed symbol 


strcspn, strtoK: string operations. 
stream editor. . 
stream. 
stream. 
stream. 
stream. 
stream. 
stream. 
stream. 
stream. 
stream status inquiries. . 
stream. 
String. a641, 164a: 
string comparision intrinsic functions. 
string. ctime, local time, 
string. 
string, format of graphical files. 
string from a stream. . 
string. 
string on a stream. : 
string operations. /strcpy, strncpy, strlen, . 
string to double-precision num ber. ; 
string to floating-point num ber. 
String to integer. . 2. 1. 6 ee eo ee we ee 
Strip: strip symbol and line number information 
strip symbol and line number information from an 
strlen, strchr, strrchr, strpbrk, strspn, strcspn,/ . 
strncat, strcmp, strncmp, strcpy, strncpy, strlen, 
strncmp, strcpy, strncpy, strlen, strchr, strrchr, . 
strncpy, strlen, strchr, strrchr, strpbrk, strspn, . 
strpbrk, strspn, strcspn, strtok: string/ /strcmp, 
strrchr, strpbrk, strspn, strcspn, strtok: string/ 
strspn, strcspn, strtok: string operations. 
strtod, atof: convert string to double-precision 
strtok: string operations. /strcpy, strncpy, 
Strtol, atol, atoi: convert string to integer. 
SEYUCtUTG: 4. tu @. se, Se wr ws SoS a ae 
stty: set the options fora terminal. ... 
su: become superuser or another user. 
subroutines and libraries. 
subroutines. . .. 1. 6 2 ee e 
subsequent lines of one file. 
substring. 
subsystem interface. 
sum: print checksum and block count of a file. 
summarize disk usage. 
summary from per-process accounting records. 
super block. ..... 
super-block. 
superuser or another user. . . « «6 © « © « 
supported by the M68KVM21 disk controller. 
supported by the M68K VM21 disk controller. 
supported by the M68K VM22 disk controller. 
suspend execution for an interval. 
suspend execution for interval. ...... 
suspend process until signal. . 
swab: swap bytes. 
swap bytes. 
sxt: pseudo-device driver. 
symbol and line number information from an n obj ject 
symbol name for object file. 
symbol table entry of a common obpet file . 
symbol table entry of a common obpet file. . 
symbol table format. . . 2. 2. 2. 2 ee eee 
symbol] table of a common ob pct file. 
symbolic debugger. 
syms: common obgct file symbol table format. 
sync: update super-block. 
sync: update the super block. 
sysdef: system definition. 
Sys_errlist, sys_nerr: system error messages. 
SYS_Derr: system error messages. . .... 
System-to-UNIX System file copy. 
table entry of a common ob fct file. 
table entry of a common obfect file. 


ae th ‘ 


e e e e e 


e e e 


fseek, . 
getc, . 


e e e 


e e e e e 


pute, 


e e e@ e 


e e e e e 


e e e e e e e e 6 

° e e e e @ e e 

e e e e e @ e ® e e 

e e e e e @ e e e ° e 
e e e e e e e e e e e 


e e e ° e e @ e e 


® 
© 
e e e @ e e e 
° eo e ° e ° e e e e e e e e e 
e e 
e e e e e e e e 
e 


e e e e e e e e e e e e e ° e e 


e 
e 
e e e e e e e e ° e e 


e e e e e e e e e e e 6 


® e e e e e e e e 


e e e e e e e 


ee. 06° e e e e ° e s e 


e 
e 
e 
e 
e 
e 
e 
e 
e e 
e 


e e e ° e e 


e e e e e 
e e e e e 


e e e e e e e e e e ° 


e e e eo e e e e oe e ° 


e e e e e o e e e ° e e eo e e e 


e e @ e e e e e e e td ® 


4 
e e e e ° e ° e e e ® e e e e 


e e ® e e e e e e e e e e e e e e e e e ° ® e @ e e e ® 


e e e ° e e e e e e e e ° ° e e e ° ° e e e ° e 


e e ° e e e 


e ° ° e e e ® | 


e e e e e e e@ e e e e 


e @ e e e ® e e e 


e e ® e 3o@ « e 


e es e e e e e e@ e 


@ 5 ® 


e e e e e e e e 
e e ® e e e e e e e e e e e e 


ws 


e e e e e e e e e Sd e e e e e e es e e e 


e e e e e e e e e e e e e e e e e e e e 


e e e e e e ° ° e ° e 


ee © &@ @ e© @ @® @® @ @® @® @® @® @® &® @ @® @® @® oe @ 


e eo e e e e e e e e e e e e e e e 


e e e e e e e @ e e e e e e e e e@ e e ® ® e e e e e e e e e e e e e e ® e e e e e e e ° e e 


string(3C) 


sed(1 


 fclose(3S) 


fopen( 3S) 
fseek(3S) 
getc(3S) 
gets(3S) 
pute(3S) 
puts(3S) 
set buf(3S) 
ferror(3S) 
ungete(3S) 
a641(3C) 
strem p( 3F) 
ctime(3C) 


index( 3F) 
v10graph(7) 
sum(1) 
du(1) 
acctcms( 1M) 
sync(1) 
sync(2) 
su(1) 

ud(7) 
vm21(7) 
vm22%7) 


strip(1) sas 
Idgetnam 

jdtbindex(3X) 
ldtbread(3X) 


Idtbindex(3X) 
idtbread(3X) 


Permuted Index 


syms: common obpct file symbol table format. ........-++6+-+2+64.... syms(4) 
master: master device information table. ....... tee ee ew ee we ew we we © 0 Master.dec(4) 
mnttab: mounted filesystem table. ..... ; Bo ee ogee ee tg ve ate TEC AD) 
ldtbseek: seek to the symbol table of a common ‘object file. we ee ee Idtbseek(3X) 
toc: graphical table of contents routines. . we ee es toc(1G) 


o e e « 
e 
e 
e 
® 
e e ° ° 
° 
e 
° 
° 
e 


setmnt: establish mount table ........e+.- : setm nt( 1M) 

hsearch, hcreate, hdestroy: manage hash search tables. . 1... eee ee ee we wee eee eee hsearch( 3C) 
tabs: set tabsonaterminal. .......-.eeeeesss. tabs(l) 
tabs: set tabs on a terminal. .....-. oe ee we tabs(1) 
tail: deliver the last part ofa file. .........-. tail(1) 


functions. sin, cos, tan, asin, acos, atan, atan2: trigonometric . .....- trig(3M) 

tan, dtan: FORTRAN tangent intrinsic function. . . . tan(3F) 

tan, dtan: FORTRAN tangent intrinsic function. . 1... 2.2562 ee ee tan( 3F) 

tanh, dtanh: FORTRAN hyperbolic tangent intrinsic function. ......2.-2-2528- tanh(3F) 
function. tanh, dtanh: FORTRAN hyperbolic tangent intrinsic . . tanh(3F) 

sinh, cosh, tanh: hyperbolic functions. ............. sinh(3M) 


tar: tape file archiver. ......4.. ie tonsa dan <a os es ange LARC) 
frec: recover files from a backup tape. .......- fe Ge ti estat tay te aie eae . frec(1M) 
filesave, tapesave daily/weekly SYSTEM V/68 file system backup. filesave(1M) 
tar: tape file archiver. . 2... ee see eee eee tar(1) 
lex: generate programs for simple lexical tasks. . . 2. 0 eee eee eee eee ee ee ee lex(l) 
hpd, erase, hardcopy, tekset, td: graphical device routines and PICCTSS. <6: a: artery gdev(1G) 
tsearch, tfind, tdelete, twalk: manage binary search tres. ...... tsearch(3C) 
tee pipe fitting. ......-.-206- we ee ew es teell) 
hpd, erase, hardcopy, tekset, td: graphical device routines and filters. ... . gdev(1G) 
4014: paginator forthe Tektronix 4014 terminal. ...... ss Boe abs eid wee 4014(1) 
init, telinit: process control initialization. .......4.. init(1M) 
tmpnam, tempnam: create a name fora temporary file. ..... tmpnam(3S) 
tmpfile: create a. temporary file. . ....5 «0 6 6 se 3 ee 6 8 Ss . tmpfile(3S) 
tmpnam, tempnam: createa name fora temporary file... 1... 1 2 eee ee wee ene tmpnam(3S) 
term: conventional names for terminals. ......e- term(S) 
term: format of compiled term file 1... 1s eee eee eee eevee term(4) 


see ee term(4) 
2 ee ©» 401401) 
.. es 45001) 
. . . terminfo(4) 
bing 4 OAC) 


term: format of compiled term file. ee 
4014: paginator for the Tektronix 4014 terminal. ...... 2... 2 eee 
450: handle special functions of the DAS] 450 terminal. ..........2-26-6 
terminfo: terminal capability data base .... 
ct: spawn getty toa remote terminal. . 2.» « + «ee ee eo © 
ctermid: generate filename for terminal. ...... 5250s soe ctermid(3S) 
greek: select terminal filter. .........-. . . 6. greek(1) 
termio: general terminal interfaces ......-.+-0s05422.4.. termio7) 


e e e e 
eo e 
° 
e 
e 


tty: controlling terminal interface ....... saat ise. > ayn tey @ SERN) 
dial: establish an out-going terminal line connection. .......-2-2-500-+08- dial(3C) 
gettydefs: speed and terminal settings used by getty. .. 2... 6.506. gettydefs(4) 
stty: set the options fora terminal. ... 1... eee eee eee ee eee . stty() 
tabs: set tabsona terminal. ........ ce cin hy Mh ia “Se, “tle Be tabs(1) 
ttyname, isatty: find nameofa terminal. . ee eee eee . es  ttyname(3C) 
getty: set terminal type, modes, speed, and line discipline. eee getty(1M) 
300s: handle special functions of DASI 300 and 300s terminals. 300, .....-.2 eee ee eee eee 3001) 
handle special functions of HP 2640 and 2621-series terminals. hp: ...... ee ee ee . . bp() 
tty: get the terminal’sname. ........ ete he Se ets Ce tty(1)) 
pg: file perusal filter for soft-copy terminals. ..........246-. Be Se, oa te dare diay pe(1) 
term: conventional names for terminals. ....... oe ee eee term(S) 
kill: terminate a process. . 2... 2. 2 ee eee eee . kill) 
shutdown: terminate all processing. ....... a a ee shutdown(1M) 
abort: terminate FORTRAN program. ......... . . abort(3F) 
exit, exit: terminate process. .......66 ats, ar een rei exit(2) 
errstop: terminate the error-logging daemon. ....... . . errstop(1M) 


wait: wait for child process to stop or terminate... 1... 2 eee sew ee ee ww we Wait(2) 
tic: terminfo compiler. .......+.e+e.2e.e-ee.. tic(1M 
tput: query terminfo database ........2-2-+4.26.-+..-... tput(l) 
terminfo: terminal capability data base. wee ee © terminfo(4) 
termio: general terminal interfac.w ......... . termio(7) 


test: condition evaluation command. ......... test(1) 
quiz: test your knowledge. ... . eas Bilstein ar UI) 
ed, red: texteditor. ..... RG, ee dey Seip dy gs er he By aes (sc ed(1) 
OXS TEXt-Oditors wis dei, eae ae Sw LS Bw . . ex(1) 
edit: text editor (variant of ex for casual users). shee! ace It) 
newform: change the format ofa text file. . 2... ....2..2..2 205622222 c cee new form(1) 
fspec: format specification in text files. ......-2220e0- eee eo we es fspect4) 
plock: lock process, text, or data in miemiory: pnar dy Bawarenees: ae 8 plock(2) 


tsearch, tfind, tdelete, twalk: manage binary search trees. . . . tsearch(3C) 
tic: terminfocompiler. .....+2-2e+.6..+-+.. ticdM 


ttt, cubic: tic-tac-toe ....... gt tgs. Se Rk aula dee ate ak eee BEE) 
activity. timex: time a command; report process data and system .. . timex(1) 
time: ‘time acommand,. <4 <.4)4 4063 eos © eS Os Se time(1) 


Sie 


Permuted Index 


mclock: return FORTRAN 
at, batch: execute commands at a later 
dcopy: copy file systems for optimal access 


profil: execution 
profile: setting up an environment at login 
stime: set 


time: get 
localtime, gmtime, asctime, tzset: convert date and 
clock: report CPU 


touch: update access and modification 
times: get process and child process 
utime: set file access and modification 
system activity. 


file. 
toupper, tolower, _toupper, _tolower, 


popen, pclose: initiate pipe 
tou pper, tolower, _toupper, 
characters. toupper, 

tsort: 

acctmerg: merge or add 
file. 

toupper, tolower, 

translate characters. 


ptrace: process 

sign, isign, dsign: FORTRAN 

toupper, tolower, _toupper, _tolower, toascii: 
tr: 

| ftw: walk a file 

tfind, tdelete, twalk: manage binary search 


Sin, CoS, tan, aSin, acos, atan, atan2: 
trenter: enter a 


pdp1i, u3b, vax, m68k: provide 
! true, false: provide 
search trees. 


current user. 

prdaily, prtacct, runacct, shutacct, startup, 

tsearch, tfind, tdelete, 

dble, cmp|x, dcmp1x, ichar, char: explicit FORTRAN 
file: determine file 

vax, m68k: provide truth value about your processor 
getty: set terminal 


types: primitive system data 
ctime, localtime, gmtime, asctime, 


processor type. pdp1l, 
the M68KVM21 disk controller. 


getpw: get name from 
mount, 


unget: 


we 


/jrand48, srand48, seed 48, lcong48: generate 


mktemp: makea 


time accounting. . 
time. 
time: get time. 
time profile. . 


e e e e e e 
° ° e e e e e 
e e e e 
° e e e e e e e e 
e e e e e ° eo e e 
e e e e e e e e e e 
e @ e e e e e e e e 
e e e ° e e e e e 
e e ® ® e e e e e 
6 e e e e e e e e 
e e e e e e ° ® e e 
e e e e e e e e o 


time... 2 « é % 

timMe@s. ux <: 4.4 

time: time a command. .. 

CLG. fioo> gee Se: esses “a ei 

time to string. ctime, ... . se mw 
time used. . . 2... Me er at ait aie ge Hae ca a aL. dae ee 


times: get process and child process times. ... 
times of a file. 


LIN GSS eco ene la Be ee ae es a Ue 


e 
e e e ° e e e nd e e e e a ° e e e 
e 
e 


LIMOS oe. ser a, See: ees “oe Ge 
timex: time a command; report process data and : 
tm pfile: create a temporary file. .......-..-. 
tmpnam, tempnam: create a name for a temporary 
toascii: translate characters. . . 
toc: graphical table of contents routines. 
to/from a process. . 61.2 ee eee eee 
_tolower, toascii: translate characters. 
tolower, _toupper, _tolower, toascii: translate 
topological sort. 
total accounting files. . ......-2 ee. 
touch: update access and modification timesofa . 
_toupper, _tolower, toascii: translate characters. . . 
toupper, tolower, _toupper, _tolower, toascii: ... 
tplot: graphics filters. ‘ 
tput: query terminfo database. 
tr: translate characters. . . . 2. 2... « 
RTACEL se Week Se: Hye ae a SS 
transfer-of-sign intrinsic function. 
translate characters. 
translate characters. . 
TIGG, be we Se ee wwe 
trees. tsearch, : 
trenter: enter a trouble report. 
trigonometric functions. 
trouble report... ...... 
true, false: provide truth values. 
truth value about your processor type. ...... 
truth values. 
tsearch, tfind, tdelete, twalk: manage binary ... 
tsort: topological sort. 
ttt, cubic: tic-tac-toe. . 2... 2. 2 ee we ow 
tty: controlling terminal interface. 
tty: get the terminal’s name. 
ttyname, isatty: find name of a terminal. 
ttyslot: find the slot in the utmp fileofthe .... 
turnacct: shell procedures for accounting. /pretmp, 
twalk: manage binary search trees. 
type conversion. /ifix, idint, real, float, sngl, 
type. 
type. pdpll, u3b, .. ‘ 
type, modes, speed, and line discipline. . 
types: primitive system datatypes. .. 
types. 
tzset: convert date and time to string. 
u3b, vax, m68k: provide truth value about your . 
ud: general driver for all disk units supported a " 


e e e ° ® o e 


e e 
eo e 

e e e e e e 
e e 

e e e e e @ e ® e e e e e e eo 
e e 


e e e e e e e e e e 


e ® e @ e 


e e e ° 


e e e e e e ° e e e e 


e e e ‘J e e 


e e e e e e e e e e e e e 


e 
© 
e 
e 
e 
e 
e 
e 
e 
e 


e e e e e e e e e e 


oo © e+ © e® oe e@ @ @@® @® @ o® @ 


e 

e e e ° @ e e 
e e e e e e eo e@ 
e 


@ e eo xo Oo @ 
ee e« @ 
e e e e re e e e od e e e e e e e e 
* eo oe @ @ ° e e 
e 
e® 
oe ef @® e@ @ @ e oe oe @ * eo @ oo @ 


e e e e e e 
e e e e e e 
e s e e e 


UD. 
ulimit: get and set user limits. ‘ 
umask: set and get file creation mask. ...... 
umask: set file-creation mode mask. : 

umount: mount and dismount filesystem. ... 
umount: unmount a filesystem. ........ 


e e e e e e e@ e e eo ¢ e e e e e e e e 


e e e e eo 


e e e 


uname: get name of current operating system. 
uname: print name of current UNIX System. . 
undo a previous get of an SCCS file. 
unget: undo a previous get of an SCCS flee ... 
ungetc: push character back into input stream. 
uniformly distributed pseudo-random numbers. . 
uniq: report repeated lines in a file. 
unique filename. 


e e e e e e 


e 2 e e e e e e 


e e e e e e e 


e e e e e e e e @ e e e@ e e e @ 


XXXi1V 


e e e e e e e e e 


° e e e e e e e e 


e e e e e e e cf e e e 6 e e ° 


e ° e e e o e e e e e ° 


e 6 e e e ® ® e 


e e e e e e e e e e e e e e e ° e e e e e ° e 


s e e e e e e ® e e e e 


o> e¢- e e&® @® @® @® © @ $@® @ @® @® @® @®@ @ @®  @ @©@ 


e e ® ® e e ° e e e e e 


e e e e °e e 


« 


e e e e 


mclock(3F) 
at(1) 
dcopy(1M) 
time(2) 
profil(2) 
profile(4) 
stime(2) 
time(1) 
timeQ) 
ctime(3C) 
clock(3C) 
times(2) 
touch(1) 
times(2) 
utime(2) 
timex(1) 
tmpfile(3S) 
tm pnam(3S) 
conv(3C) 
toc(1G) 
popen( 3S) 
conv(3C) 
conv(3C) 
tsort(1) 
acctmerg(1M) 
touch(1) 
conv(3C) 
conv(3C) 
tplot(1G) 
tput(1) 
tr(1) 
ptrace(2) 
sign(3F) 
conv(3C) 
tr(1) 
ftw(3C) 
tsearch(3C) 
trenter(1M) 
trig(3M) 


. trenter(1M) 


true(1) 
machid(1) 
true(1) 
tsearch(3C) 
tsort(1) 
ttt(6) 
tty(7) 
tty(1) 
ttyname(3C) 
ttyslot(3C) 
acctsh(1M) 


_tsearch(3C) 


ftype(3F) © 
file(1) 
machid(1) 
getty( 1M) 
types(S) 
types(S) 
ctime(3C) 
machid(1) 
ud(7) 
getpw(3C) 
ulimit(2) 
umask(2) 
umask(1) 
mount(1M) 
umount(2) 
uname(2) 
uname(1) 
unget(1) 
unget(1) 
ungetc(3S) 
drand48(3C) 
uniq(1) 
mktem p( 3C) 


ud: general driver for all disk 

vm21: default general driver for all disk 
vm22: default general driver for all disk 
cm16: 16Mb Cartridge Module Drive for 
cm80: 80Mb Cartridge Module Drive for 
fi8: 8-inch Floppy Disk Drive for 

Irk25: 25Mb LARK Module Drive for 
uux: 

link, 


link, unlink: exercise link and 

umount: 

pack, pcat, 

touch: 

make: maintain, 

lsearch, Ifind: linear search and 

sync: 

sync: 

du: sum marize disk 

Stat: statistical network 

id: print 

setuid, setgid: set 

crontab: 

cuserid: get character login name of the 
group/ getuid, geteuid, getgid, getegid: get real 
environ: 

diskusg: generate disk accounting data by 
ulimit: get and set 

logname: return login name of 

geteuid, getgid, getegid: get real user, effective 
su: become superuser or another 

find the slot in the utmp file of the current 
write: write to another 

edit: text editor (variant of ex for casual 
mail, rmail: send mail to 

wall: write to all 

fuser: identify processes 


gutil: graphical 


utmp, wtmp: 
pututline, setutent, endutent, utmpname: access 
ttyslot: find the slot in the 


getutid, getutline, pututline, setutent, endutent, 


uusub: monitor 
uuclean: 
uustat: 


uucp, 
uucp, uulog, 
copy. uuto, 


file copy. 


val: 

pdpi1, u3b, vax, m68E: provide truth 

abs: return integer absolute 

abs, iabs, dabs, cabs, zabs: FORTRAN absolute 
getenv: return 

fmod, fabs: floor, ceiling, remainder, absolute 
putenv: change or add 


true, false: provide truth 
values: machine-dependent 
vfprintf, vsprintf: print formatted output of a 


varargs: handle 
getenv: return FORTRAN environment 
edit: text editor 


Permuted Index 


KXXXV 


units(1) 


units: conversion program. ....-2-.+ eee ae 

units supported by the M68KVM21 disk controller. . . ud(7) 
units supported by the M68K ‘M21 disk controller. . . vm21(7) 
units supported by the M68K VM22 disk controller. . . vm22(7) 
Universal Disk Driver. ......226066- eee es cmlG7) 
Universal Disk Driver. . . 2... 22 0 0 se © © © « s CMBMXK7) 
Universal Disk Driver... .. 1.2222 eee . .. f8(7) 
Universal Disk Driver. ........-2.20024. . Irk25(7) 
UNIX-to-UNIX system command execution. .... . uux(iC) 
unlink: exercise link and unlink system calls. .. . . link(1M) 
unlink: remove directory entry. ......-eee.e-s unlink(2) 
unlink system calls. 2... 2 ee ee ee ee eee es link(1M) 
unmount a filesystem. .....2-eee cc cees umount(2) 
‘unpack: compress and expand files. ......... pack(1) 
update access and modification times of a fle. ..... touch(1) 
update, and regenerate groups of programs. ...... make&1) 
WOCAtes, Sei 2s ele ae vache Siw Seeley SS isl ee hg Isearch(3C) 
update super-block. ........06e06e-.- eo. « ~ sync(2) 
update the super block. . 2... 2 ee ee ee eee sync(1) 
USHOGS. 6 de> 4° ch 4) eg aah cat ON cig ie. ices aes Ge rene el ee du(1) 
useful with graphical commands: e066 % 6 es .« stat(1G) 
user and group IDs and names. .......2e06-. id(1) 

user and group IDs. i ie, ie See: 2) eveedass . setuid(2) 
user crontab files. ¢- 406 dec oer ss We Sow. we OS . « crontab(1) 
USED es ie a. 56 ee 16 aR ig A SS es, He ER cuserid(3S) 
user, effective user, real group, and effective ..... getuid(2) 
user environment. ... 2.2... ee ee ee eee environ(S) 
USC TDS ay ee, ae eeee Oe ae Sek ee Ste, Ge ee ee 8 disk usp(1M) 
user limits. ......- ee ree ee ee ulimit(2) 
UWSORss olesse gh se oo a wes 0. he cw ee eee ee ee logname(3X) 
user, real group, and effective group IDs. getuid, .. . getuid(2) 
USCS 2o ance ee en Bae BSE de See eS su(1) 
user. ttyslot: ...... Sle ee wap See ata gar Aah vane . ttyslot(3C) 
USCLDs... 6:35 6S Wah We Sie See eae Mt ete) 
USCIS): AG eno ace S be Sw oes Baek ~... edit(1) 
users or read mail. .. 1.62 2 0 0 ee ee eee © mail(l) 
USOISs, 5b. oe aS: oe toh ei cw a Bt ae 6 anna canoes wall(1M) 
using a file or file structure... ......... ~~. fuser(1M) 
ustat: get file system statistics. ........-.. . ustat(2) 
utilities. ...... plate -ar wit We. eee ee gutil(1G) 
utime: set file access and modification times. .... . utime(2) 
utmp and wtmp entry formats. ........... utmp(4) 
utmp file entry. petutent, getutid, getutline, . .... getut(3C) 
utmp file of the current user. . ....2.2.-22000- ttyslot(3C) 
utmp, wtmp: utmp and wtmp entry formats. ... . utmp(4) 
utmpname: access utmp file entry. getutent, ..... getut(3C) 
uuclean: uucp spool directory clean-up. ....... uuclean( 1M) 
UUCP NECWOrK: «6 6 ee 4 Se UW eee we we ce 6 uusub(1M) 
uucp spool directory clean-up. . 2... 2.2 eee ee uuclean(1M) 
uucp status inquiry and jobcontrol. .......-- uustat(1C) 
uucp, uulog, uuname: unix to unix copy. ...-+..-- uucp(1C) 
uulog, uuname unix to unixcopy........e..-. uucp(1C) 
uuname: unix to unix copy. ....-..-s+eeee- uucp(1C) 
uupick: public UNIX System-to-UNLX System file . . . uuto(1C) 
uustat: uucp status inquiry and jpbcontrol. ..... uustat(1C) 
uusub: monitor uucp network. .......2-2-20- uusub(1M) 
uuto, uupick: public UNIX System-to-UN_X System . . uuto(1C) 
uux: UNCX-to-UNIX system command execution. .. . uux(1C) 
vl0graph - VME/10 graphics subsystem interface. . . vl0graph(7) 
val: validate SOCS file. .......0.020202000e6- val(1) 
Validate:SOCS GIG: Sa ance 6) a eS 4 Sse se val(1) 
value about your processor 2 machid( 1 ) 
Values uaa e-waste ae 16 es ena ere abs(3C) 
ValUCs. -%. ae 4 GS eS se een Sees ae Li: Sa Giwe we abs(3F) 
value for environment name. .... 2.2222 getenv(3C) 
value functions. floor,ceil, . . 1... ee ee ee ee floor(3M) 
value toenvironment. .....-2+s-e eee eee putenv(3C) 
values: machine-dependent values. .......2... values(S) 
VALUES... 55.628 Ee Bee deb esd HB See le BA true(1) 
values. . 2... iehbc ah. de ie Sa twas ee. demas Stas ae values(S) 
varargs argument list. vprintf, ..........-. vprintf(3S) 
varargs: handle variable argument list. ........ varargs(S) 
variable argument list. ....-.-22-2 22 eee varargs(5) 
Variables, “a-226 wos a 2S eee i.e we es, BS getenv(3F) 
(variant of ex for casual users). Ge, eh Regs ve Ne. edit(1) 


Permuted Index 


type. pdpl1, 3b, 
fscv: convert files between M68000 and 


getopt: get option letter from argument 

assert: 

NC: 

get: get a 

sccsdiff: compare two 

varargs argument list. vprintf, 

on ex. 

vi: screen-oriented 

supported by the M68K VM21 disk controller. 
cmd16: 16Mb Cartridge Module Drive for 

cmd80: 80Mb Cartridge Module Drive for 

lark2S: SOMb LARK Module Drive for 

lark8: 16Mb LARK Module Drive for 

sa800fi21: 8-inch Floppy Disk Drive for 

supported by the M68K VM22 disk controller. 
vm22fmt: format disks on the 

16Mb Cartridge Module Drive for VM21 Driver and 
80Mb Cartridge Module Drive for VM21 Driver and 
lark25: SOMb LARK Module Drive for VM21 Driver and 
lark8: 16Mb LARK Module Drive for VM21 Driver and 
sa400f122: 54-inch Floppy Disk Drive for 
sa800fi22: 8-inch Floppy Disk Drive for 


bootstrap operating procedure for system restart on 
-vil0graph - 

wffmt: format floppies for the 

checking. 

file system: format of system 

of a varargs argument list. 

argument list. vprintf, vfprintf, 


Wait: 


ftw: 

signal: specify 

crash: 

whodo: 

who: 

wd15: 1SMb 

wd40: 40Mb 

sa400fwd: S¥-inch Floppy Disk Drive for the 
cd: change 


chdir: change 

getcwd: get pathname of current 
pwd: 

write: 

putpwent: 

wall: 

write: 


open: open for reading or 
utmp, wtmp: utmp and 
utmp, 

fwtmp, 


command. 
functions. and, or, 
ih 

p, ji, mn, yO, 


p, ji, jn, yO, yl, 
abs, iabs, dabs, cabs, 


vax, m68k: provide truth value about your processor . machid(1) 
VAX-11/780 processors. ...... oe ee oo » « fscvlM). 
ve: version control. . 6... 1 0s ee tee ew eae ve(1) 
vector. ..... Sid wae a Beis ee SB Oe Oe SG DO COpPUIO) 
verify program assertion. . .. 1... ee ee « « assert(3X) 
version control. .... ees ee eee ee «wa VEL) 
version of an SOCS file. . 2... ee ee ee ew ee get(1) 
versions of an SCCS file. ©. 5. 66s sas ws bw sccesdiff(1) 


vfprintf, vsprintf: print formatted output ofa ... 


. vprintf(3S) 


vi: screen-oriented (visual ) display editor based . . ~~. viC1) 
(visual) display editor based on ex. .....-.e2e- vil) 

vm21: default general driver for all disk units .. .. vm21(7) 
VM21 Driver and VM22 Driver. .......2e.2-. cmd 16(7) 
VM21 Driver and VM22 Driver. ....... . - - cmd80(7) 
VM21 Driver and VM22 Driver. .........2. lark2S(7) 
VM21 Driver and VM22 Driver. be ao eee Mark8) 

NN MOT DTV Ere “ws, ss Sn es soe ces Se ele fae we ee So - » sa800f21(7) 
vm22: default general driver for all disk units .. .. vm22(7) 
VM22 disk controller, ........26.4.0.e8e0e-8 . vm22fmt( 1M) 
VM22 Driver. cmd16: ........262ee-6 . - . cmdlé(7) 
VM22 Driver. cmd80: .........2.26-e . « - cmd8X7) 
NIM2 2 Drivers a ie Set wontacdy wears ees: ds ote ee ed lark2S(7) 
WIVD2 DriVGr.. és 465 sa. chee Se. 8) Be a Sw, Sais ee, he lark 8(7) 
VM22 Driver. Sie hc AC oe tA OE ee an sie eat we sa400f122(7) 
WI? Driver, 38s 4 es 6 SS ae we SESS sa800f122(7) 


XXXVI 


. vm22fmt(1M) 


VME/10: DOVE? 255 S. o-a-e dé Goad eb ele ae Ss bo.vme(8) 
VME/10 graphics subsystem interface ...... . « vlOpraph(7) 
“VME/10 processor. 2... 0 ee eee ee te tes w ffmt( 1M) 
volcopy, labelit: copy file systems with label . .... volecopy(1M) | 
VOIGIIG:: 60a; 18. Rese, Bch i as Ce, BS se: @ ee ee fs(4) 
vprintf, vfprintf, vsprintf: print formatted output . . vprintf(3S) 
vsprintf: print formatted output of a varargs ..... vprintf(3S) 
wait: await completion of process. ....... . . . wait(1) 
wait for child process to stop or terminate. ...... wait(2) 
wait: wait for child process to stop or terminate... wait(2) 
walkafiletren . 2... 2 ee ee ww ee ee we ftw(3C) 
wall: write toall users. 6 ww ww eee ee . » wall(1M) 
we: word count. . 2... eee ee eee ee ee we(1) 
wd15: 1SMb Winchester Disk Drive. ....... . wdlS(7) 
wd40: 40Mb Winchester Disk Drive. ........ wd407) 
wffmt: format floppies for the VME/10 processor. . . . wffmt(1M) 
what: identify SCCS files. ...... re ane ae a what(1) 
what to do upon receipt of asignal. .......-. . signal(2) 
what to do when the system crashes. ...... «. crash.macs(8) 
Whois doing What. 66 gs we © Siw SS we eS whodo( 1M) 
who is on thesystem. .. 1... 2.20 es sees who(1) 
who: who is on the system. . .. 2... eee eee who(1) 
whodo: who is doing what. ........-.220060- whodo( 1M) 
Winchester Disk Drive. ...... Soke ge. ta aap | ei wd15(7) 
Winchester Disk Drive. .......2002-0000- wd4X7) 
Winchester Disk Driver. ........-206-5 . . sa400fiw d(7) 
WOTk ing dITECtOrys- 4. a: So ay ee ve, Bw Gee he cd(1) 
working directory. .....-.-5056-e-25008- . . . chdir(2) 
working directory. .......6-556520e08-. . +. getcwd(3C) 
working directory name. .. 1.6.5.2. 50 eee eee pwd(1) 
WTItGON afles: “nce, WOR SBS SS oe ew we Write(2) 
write password file entry. wee ew we ee ew oe oe © putpwent(3C) 
write toall users. ....... ese Oe Bee ot & So WallM) 
write to another user. be oe: Geet Bid We Hac eee, EIB) 
write: write ona file. ........62002040. write2) 
write: write to another user. .......0-. - . write(1) 
WHItING. 6s Gi Rides hee eee we ae 8 . . open(2) 
wimp entry formats. ....... we ee ee ee Utmpl) 
wtmp: utmp and wtmp entry formats. ..... - . utmp(4) 
wtmpfix: manipulate connect accounting records. . . . fwtmp(1M) 
wump: the game of hunt-the-wumpus. ....... wump(6) 
Xargs: construct argument list(s) and execute ..... xarps( 1) 
xor, not, Ishift, rshift: FORTRAN bitwise Boolean . . . bool(3F) 
yO, yl, yn: Bessel functions. .......2-+e+e-6 . bessel(3M) 
yl, yn: Bessel functions. 2... 1... 222s ee ee bessel(3M) 
yacc: yet another compiler-compiler. ...... 2 e+ yaoc(1) 

yn: Bessel functions. 2... 6 ee eee ee ew ee bessel(3M) 
zabs: FORTRAN absolute value. ....... 4... . abs(3F) 


INTRO( 1M) INTRO( 1M) 


NA ME 


intro — introduction to system maintenance commands and application programs 


DESCRIPTION 


This section describes, in alphabetical order, commands that are used chiefly for system 
maintenance and administration purposes. The commands in this section should be used along 
with those listed in Section 1 of the SYSTEM V/68 User's Manual. References to other 
manual entries not of the form name(1M), name(7) or name(8) refer to entries of that 
manual. 


COMMAND SYNTAX 


Unless otherwise noted, commands described in this section accept options and other argu- 
ments according to the following syntax: 


name [option(s )] [cmdarg(s )] 


where: 
name The name of an executable file. 
option — noargletter(s ) or, 


— argletter < >optarg 
where <> is optional white space. 


noargletter <A single letter representing an option without an argument. 


ar gletter A single letter representing an option requiring an argument. 
optarg Argument (character string) satisfying preceding argletter. 
cmdarg Pathname (or other command argument) not beginning with — or, — by itself 


indicating the standard input. 


SEE ALSO 


getopt(1), getopt(3C). 
SYSTEM V/68 User's Manual . 
SYSTEM V/68 Administrator's Guide . 


DIAGNOSTICS 


BUGS 


Upon termination, each command returns two bytes of status, one supplied by the system and 
giving the cause for termination, and (in the case of “normal” termination) one supplied by 
the program (see wait (2) and exit (2)). The former byte is 0 for normal termination; the latter 
is customarily O for successful execution and non-zero to indicate troubles such as erroneous 
parameters, bad or inaccessible data, or other inabilities to cope with the task at hand. It is 


called variously “exit code”, “exit status”, or “return code”, and is described only where special 
conventions are involved. 


Some commands do not adhere to the syntax mentioned above. 
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NAME 
accept, reject — allow/prevent LP requests 
SYNOPSIS 
/usr/lib/accept destinations 
/usr/lib/reject [—r[ reason ]] destinations 


DESCRIPTION 
Accept allows lp(1) to accept requests for the named destinations. A destination can be 
either a printer or a class of printers. Use lpstat(1) to find the status of destinations. 


Reject prevents lp(1) from accepting requests for the named destinations. A destination can 
be either a printer or a class of printers. Use lpstat(1) to find the status of destinations. The 
following option is useful with reject. 


—r[ reason] Associates a reason with preventing lp from accepting requests. This reason 
applies to all printers mentioned up to the next —r option. Keason is reported 
by lp when users direct requests to the named destinations and by lpstat(1). If 
the —r option is not present or the —r option is given without a reason, then a 
default reason will be used. 

FILES 
/usr/spool/1p/* 
SEE ALSO 
enable(1), Ip(1), lpadmin(1M), lpsched(1M), Ipstat(1). 
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NAME 
acctdisk, acctdusg, accton, acctwtmp — overview of accounting and miscellaneous accounting 


commands 


SYNOPSIS 
/usr/lib/acct/acctdisk 


/usr/lib/acct/acctdusg [—u file] [—p file ] 
/usr/lib/acct/accton [ file | 


/usr/lib/acct/acctwtmp "reason" 


DESCRIPTION 
Accounting software is structured as a set of tools (consisting of both C programs and shell 
procedures) that can be used to build accounting systems. Acctsh(1M) describes the set of 
shel] procedures built on top of the C programs. 


Connect time accounting is handled by various programs that write records into 
/usr/adm/utmp, as described in utmp(4). The programs described in acctcon(1M) convert 
this file into session and charging records, which are then summarized by acctmerg(1M). 


Process accounting is performed by the SYSTEM V/68 kernel. Upon termination of a process, 
one record per process is written to a file (normally /usr/adm/pacct). The programs in 
acct prc(1M) summarize this data for charging purposes; acctcms(1M) is used to summarize 
command usage. Current process data may be examined using acctcom(1). 


Process accounting and connect time accounting (or any accounting records in the format 
described in acct(4)) can be merged and summarized into total accounting records by 
acctmerg (see tacct format in acct(4)). Prtacct (see acctsh(1M)) is used to format any or all 
accounting records. 


Acetdisk reads lines that contain user ID, login name, and number of disk blocks and converts 
them to total] accounting records that can be merged with other accounting records. 


Acctdusg reads its standard input (usually from find / —print) and computes disk resource 
consumption (including indirect blocks) by login. If —uw is given, records consisting of those 
filenames for which acctdusg charges no one are placed in file (a potential source for finding 
users trying to avoid disk charges). If —p is given, file is the name of the password file. This 
option is not needed if the password file is /etc/passwd (refer to diskusg(1M) for more 
details). | 


Accton alone turns process accounting off. If file is given, it must be the name of an existing 
file, to which the kernel appends process accounting records (see acct(2) and acct(4)). 


_Acctwtmp writes a utmp(A4) record to its standard output. The record contains the current 
time and a string of characters that describe the reason. A record type of ACCOUNTING is 
assigned (see utmp(4)). Reason must be a string of 11 or less characters, numbers, $, or spaces. 
For example, the following is a suggestion for use in shutdown procedures: 


acctwtmp "file save” >> /etc/wtmp 


FILES 
/etc/passwd used for login name to user ID conversions 
/usr/lib/acct holds all accounting commands listed in 
| sub-class 1M of this manual 
/usr/adm/pacct current process accounting file 
/etc/wimp login/logoff history file 
SEE ALSO 
acctems(1M), acctcom(1), acetcon(1M), acctmere(1M), acetpre(1M), acctsh(M), fwtmp(1M), 
runacet(1M), acct(2), acet(4), utmp(4). 
“Accounting” in the S¥ STEM V/68 Administrators Guide. 
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NAME | 

acctcms — command summary from per-process accounting records 
SYNOPSIS | 

/usr/lib/acct/acctcms [options] files 
DESCRIPTION | 

Acctcms reads one or more files, normally in the form described in acct(4). It adds all 

records for processes that executed identically-named commands, sorts them, and writes them 

to the standard output, normally using an internal summary format. The options are: 

—a Print output in ASCII rather than in the internal summary format. The output 
includes command name, number of times executed, total kcore-minutes, total CPU | 
minutes, total real minutes, mean size (in K), mean CPU minutes per invocation, “hog 
factor”, characters transferred, and blocks read and written, as in acctcom(1). Output 
is normally sorted by total kcore-minutes. 

—C Sort by total CPU time, rather than total kcore-minutes. 

—]j Combine all commands invoked only once under “***other”. 

—n Sort by number of command invocations. 

—S Any file names encountered hereafter are already in internal summary format. 

—t Process all records as total accounting records. The default internal summary format 
splits each field into prime and non-prime time parts. This option combines the prime 
and non-prime time parts into a single field that is the total of both, and provides 
upward compatibility with old (i.e, UNIX System V) style acctcms internal summary 
format records. 

The following options may be used only with the —a option: 

—=p Output a prime-time-only command summary. 

—O Output a non-prime (offshift) time only command summary. 

When —p and —o are used together, a combination prime and non-prime time report is pro- 

duced. Al] the output summaries will be total usage except number of times executed, CPU 

minutes, and real minutes, which will be split into prime and non-prime. 

A typical sequence for performing daily command accounting and for maintaining a running 

total is: 
acctcms file ... >today 
cp total previoustotal 
acctcms —s today previoustotal > total 
acctcms —a —s today 

SEE ALSO 


acct(1M), acctcom(1), acctcon(1M), acctmerg(1M), acctprc(1M), acctsh(1M), fwtmp(1M), 
runacct(1M), acct(2), acct(4), utmp(4). 


CAUTION 
The current acctcms can still read, process, and generate command accounting records compa- 
tible with previous SYSTEM V/68 releases if the —t option is used. Note, however, that inter- 
nal summary records generated with the —t option (or by the SYSTEM V/68 Release 1 ver- 
sion) are not compatible with those created by the Release 2 acctcms without this option. 
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NAME 


acctconl, acctcon2 — connect-time accounting 


SYNOPSIS 


/usr/lib/acct/acctcon1 [options] 
/usr/lib/acct/acctcon2 


DESCRIPTION 


Acctconil converts a sequence of login/logoff records read from its standard input to a 
Sequence of records, one per login sessidn. Its input should normally be redirected from 
/etc/wtmp. Its output is ASCII, giving device, user ID, login name, prime connect time 
(seconds), non-prime connect time (seconds), session starting time (numeric), and starting date 
and time. The options are: 


—p Print input only, showing line name, login name, and time (in both numeric and 
date/time formats). 
—t Acctcon] maintains a list of lines on which users are logged in. When it reaches the 


end of its input, it emits a session record for each line that still appears to be active. 
It normally assumes that its input is a current file, so that it uses the current time as 
the ending time for each session still in progress. The —t flag causes it to use, 
instead, the last time found in its input, thus assuring reasonable and repeatable 
numbers for non-current files. 

—l file File is created to contain a summary of line usage showing line name, number of 
minutes used, percentage of total elapsed time used, number of sessions charged, 
number of logins, and number of logoffs. This file helps track line usage, identify 
bad lines, and find software and hardware oddities. Hang-up, termination of 
login(1) and termination of the login shell generate logoff records, so that the 
number of logoffs is often three to four times the number of sessions. See init (1M) 
and utmp(A). | 

—o file File is filled with an overall record for the accounting period, giving starting time, 
ending time, number of reboots, and number of date changes. 


Acctcon2 expects as input a sequence of login session records and converts them into total 
accounting records (see tacct format in acct(4)). 


EX AMPLES 


FILES 


These commands are typically used as shown below. The file ctmp is created only for the use 
of acct prc(AM) commands: 


acctcon1 —t —] lineuse —o reboots <wtmp | sort +in +2 >ctmp 
acctcon2 <ctmp | acctmerg >ctacct 


/etc/wtmp 


SEE ALSO 


BUGS 


acct(1M), acctcms(1M), acctcom(1), acctmerg(1M), acctprc(1M), acctsh(1M), fwtmp(1M), 
runacct(1M), acct(2), acct(4), utmp(4). 


The line usage report is confused by date changes. Use wtmp fix (see fwtmp(1M)) to correct 
this situation. 
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NAME 
acctmerg — merge or add total accounting files 
SYNOPSIS | 
/usr/lib/acct/acctmerg [options] [file]... 


DESCRIPTION 

_ Acctmerg reads its standard input and up to nine additional files in the tacct format (see 
acct(4)) or in an ASCII version. It merges these inputs by adding records whose keys (nor- 
mally user ID and name) are identical and expects the inputs to be sorted on those keys. 
Options are: | | 
—a Produce output in ASCII version of tacct. 
—i Input files are in ASCII version of tacct. 
—p Print input with no processing. 
—t Produce a single record that totals all input. 
—u Summarize by user ID, rather than user ID and name. 
—v Produce output in verbose ASCII format, with more precise notation for floating point 

numbers. 


The following sequence is useful for making repairs to any file kept in this format: 
acctmerg —v <filel >file2 

Perform edit on file2, then enter: 
acctmerg —1i <file2 >filel 


SEE ALSO | 
acct(1M), acctems(1M), acctcom(1), acctcon(1M), acctprc(1M), acctsh(1M), fwtmp(1M), 
runacct(1M), acct(2), acct(4), utmp(4). 
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NAME 


acctprcl, acctprc2 — process accounting 


SYNOPSIS 


/usr/lib/acct/acctprce1 [ctmp] 
/usr/lib/acct/acctprc2 


DESCRIPTION 


Acct prcl reads input in the form described by acct(4), adds login names corresponding to 
user IDs, then writes for each process an ASCII line giving user ID, login name, prime CPU time 
(tics), non-prime CPU time (tics), and mean memory size (in 64-byte units). If ctmp is given, 
it is expected to contain a list of login sessions, in the form described in acctcon(1M), sorted by 
user ID and login name. If this file is not supplied, it obtains login names from the password 
file. The information in ctmp helps it distinguish among different login names-that share the 
Same user ID. 


Acct pre2 reads records in the form written by acctprc], summarizes them by user ID and 
name, then writes the sorted summaries to the standard output as total accounting records. 


These commands are typically used as shown below: 


acctprcl ctmp </usr/adm/pacct | acctprc2 > ptacct 


FILES 
/etc/passwd 

SEE ALSO | 
acct(1M), acctcms(1M), acctcom(1), acctcon(1M), acctmerg(1M), acctsh(1M), fwtmp(1M), 
runacct(1M), acct(2), acct(4), utmp(4). 

BUGS 
Although it is possible to distinguish among login names that share user IDs for commands run 
normally, it is difficult to do this for those commands run from cron(1M), for example. More 
precise conversion can be done by faking login sessions on the console via the acctwtmp pro-— 
gram in acct(1M). 

CAUTION 


A memory segment of the mean memory size is a unit of measure for the number of bytes in 
a logical memory segment on a particular processor. For example, on a PDP-11/70 this meas- 
ure would be in 64-byte units; on a VAX11/780, EXORmacs, or VME/10 it would be in 512- 
byte units. 
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NAME 
chargefee, ckpacct, dodisk, lastlogin, monacct, nulladm, prctmp, prdaily, prtacct, runacct, shu- 
tacct, startup, turnacct — shell procedures for accounting 


SYNOPSIS 
/usr/lib/acct/chargefee login-name number 


/usr/lib/acct/ckpacct [blocks] 
/usr/lib/acct/dodisk [—o] [files ..] 

/usr /lib/acct/lastlogin 
/usr/lib/acct/monacct number 
/usr/lib/acct/nulladm file 
/usr/lib/acct/prctmp 

/usr/lib/acct/prdaily [—1] [—c] [ mmdd ] 
/usr/lib/acct/prtacct file [ “heading” ] 
/usr/lib/acct/runacct [mmdd] [mmdd state] 
/usr/lib/acct/shutacct [ "reason" ] 
/usr/lib/acct/startup 
/usr/lib/acct/turnacct on | off | switch 


DESCRIPTION 
Charge fee can be invoked to charge a number of units to login-name. A record is written to 
/usr/adm/fee, to be merged with other accounting records during the night. 


Ck pacct should be initiated via cron(1M). It periodically checks the size of /usr/adm/pacct. 
If the size exceeds blocks, 1000 by default, turnacct is invoked with argument switch. If the 
number of free disk blocks in the /usr file system falls below 500, ckpacct automatically 
turns off the collection of process accounting records via the off argument to turnacct. When 
at least this number of blocks is restored, accounting is reactivated. This feature is sensitive to 
the frequency at which ck pacct is executed, usually by cron. 


Dodisk should be invoked by cron to perform the disk accounting functions. By default, it 
will do disk accounting on the special files in /etc/checklist. If the —o flag is used, it will 
do a slower version of disk accounting by login directory. Files specify the one or more 
filesystem names where disk accounting will be done. If files are used, disk accounting will 
be done on these filesystems only. If the —o flag is used, files should be mount points of 
mounted filesystems. If omitted, they should be the special filenames of mountable filesys- 
tems. 


Lastlogin is invoked by runacct to update /usr/adm/acct/sum/loginlog, which shows the 
last date on which each person logged in. 


Monacct should be invoked once each month or each accounting period. Number indicates 

which month or period it is. If number is not given, it defaults to the current month 
(01—12). This default is useful if monacct is to be executed via cron(1M) on the first day of 
each month. Monacct creates summary files in /usr/adm/acct/fiscal and restarts summary 
files in /usr/adm/acct/sum. 


_Nulladm creates file with mode 664 and insures owner and group are adm. It is called by 
various accounting shell procedures. 


Prctmp can be used to print the session record file (normally /usr/adm/acct/nite/ctmp 
_ created by acctcon! (see acctcon(1M)). 


Prdaily is invoked by runacct to format a report of the previous day’s accounting data. The 
report resides in /usr/adm/acct/sum/rprtmmdd, where mmdd is the month and day of the 


ee 
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report. The current daily accounting reports may be printed by typing prdaily. Previous 
days’ accounting reports can be printed by using the mmdd option and specifying the exact 
report date desired. The —1 flag prints a report of exceptional usage by login id for the 
specified date. Previous daily reports are cleaned up and, therefore, inaccessible after each 
invocation of monacct. The —c flag prints a report of exceptional resource usage by command 
and may be used on current day’s accounting data only. 


Prtacct can be used to format and print any total accounting (tacct) file. 


Runacct performs the accumulation of connect, process, fee, and disk accounting on a daily 
basis. It also creates summaries of command usage. For more information, see runacct (1M). 


Shutacct should be invoked during a system shutdown (usually in /etc/shutdown) to turn 
process accounting off and append a “reason” record to /etc/wtmp. 


Startup should be called by /etc/rc to turn the accounting on whenever the system is 
brought up. 


Turnacct is an interface to accton (see acct(1M)) to turn process accounting on or off. The 
switch argument turns accounting off, moves the current /usr/adm/pacct to the next free 
name in /usr/adm/pacctincr (where incr is a number starting with 1 and incrementing by 
one for each additional pacct file), then turns accounting back on again. This procedure is 
called by ckpacct and thus can be taken care of by the cron and used to keep pacct to a rea- 
sonable size. 


FILES 
/usr/adm/fee accumu lator for fees 
/usr/adm/pacct current file for per-process accounting 
/usr/adm/pacct* used if pacct gets large and during 
execution of daily accounting procedure 
/etc/wtmp login/logoff summary 
/usr/lib/acct/ptelus.awk contains the limits for exceptional 
usage by login id 
/usr/lib/acct/ptecms.awk contains the limits for exceptional 
usage by command name 
/usr/adm/acct/nite working directory 
/usr/lib/acct holds all accounting commands listed in 
sub-class 1M of this manual 
/usr/adm/acct/sum summary directory, should be saved 
SEE ALSO 


acct(1M), acctcms(1M), acctcom(1), acctcon(1M), acctmerg(1M), acctprc(1M), fwtmp(1M), 
runacct(1M), acct(2), acct(4), utmp(4). 


BCOPY (1M ) | | : BCOPY (1M) 


NAME 

bcopy — interactive block copy 
SYNOPSIS 

/etc/bcopy 
DESCRIPTION 


Bcopy copies from and to files starting at arbitrary block (512-byte) boundaries. 
The following questions are asked: | 


to: (you name the file or device to be copied to) 
offset: (you provide the starting “to” block number) 
from: (you name the file or device to be copied from) 
offset: (you provide the starting “from” block number) 


count: (you reply with the number of blocks to be copied) 


After count is exhausted, the from question is repeated (providing the ability to concatenate 
blocks at the to+offset+count location). If from is answered with a carriage return, every- 
thing starts over. 


Two consecutive carriage returns terminate bcopy. 


SEE ALSO 
cpio(1), ddQ). 
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NAME 


brc, bcheckrc, rc, powerfail — system initialization shell scripts 


SYNOPSIS 


/etc/brc 
/etc/bcheckrc 
/etc/rc 


/etc/powerfail 


DESCRIPTION 


Except for power fail, these shell procedures are executed via entries in /etc/inittab by 
init(1M) when the system is changed out of single-user mode. Power fail is executed when- 
ever a system power failure is detected. 


The drc procedure clears the mounted file system table /etc/mnttab (see mnttab(4)) and 
loads any programmable microprocessors with their appropriate scripts. 


The bcheckrc procedure performs all the necessary consistency checks to prepare the system to 
change into multi-user mode. It will prompt to set the system date and to check the file sys- 
tems with fsck(1M). 


The rc procedure starts all system daemons before the terminal lines are enabled for multi- 
user mode. In addition, file systems are mounted and accounting, error logging, and system 
activity logging are activated in this procedure. 


The power fail procedure is invoked when the system detects a power failure condition. Its 
chief duty is to reload any programmable microprocessors with their appropriate scripts, if 
suitable. It also logs the fact that a power failure occurred. 


These shell procedures, in particular rc, may be used for several run-level states. The who(1) 
command may be used to get the run-level information. 


SEE ALSO 


fsck(1M), init(1M), shutdown(1M), who(1), inittab(4), mnttab(4). 
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NAME 

checkall — faster file system checking procedure 
SYNOPSIS 

/etc/checkall 
DESCRIPTION 


The checkall procedure is a prototype and must be modified to suit local conditions. The fol- 
lowing will serve as an example: | 


# check the root file system by itself 
fsck /dev/rdsk/cnirlr_OsO0 


# dual fsck of drives.O and 1 | 
dfsck /dev/rdsk/cntrir_0s[12345] — /dev/rdsk/cntrir_1s0 


If /dev/rdsk/cntrir_1s0 is 320K blocks and /dev/rdsk/cntrir_Os{ 12345] are each 65K or 
less, a previous sequential fsck took 19 minutes. The checkall procedure takes 11 minutes. 


Dfsck is a program that permits an operator to interact with two fsck(1M) programs at once. 
To aid in this, dfsck will print the file system name for each message to the operator. When 
answering a question from dfsck, the operator must prefix the response with a 1 or a 2 (indi- 
cating that the answer refers to the first or second file system group). 


Due to the file system load balancing required for dual checking, the dfsck command should 
always be executed through the checkall shell procedure. 


In a practical sense, the file systems are divided as follows: 
dfsck file_systems_on_drive_0 — file_systems_on_drive_1 
dfsck file_systems_on_drive_2 — file _systems_on_drive_ 3 


A three-drive system can be handled, as shown in the following example (assumes two large 
file systems per drive): 


dfsck /dev/dsk/cntrir_3s1 /dev/dsk/cntrir_Os[14] — /dev/dsk/cntrir_1s[14] /dev/dsk/cntrir_3s4 
Note that the first file system on drive 3 is first in the filesystems] list and is last in the 
filesystems2 list, assuring that references to that drive will not overlap at execution time. 
WARNINGS 
1. Do not use dfsck to check the root file system. 


2. On a check that requires a scratch file (refer to the —t option of dfsck), be careful not to 
use the same temporary file for the two groups (this is sure to scramble the file systems). 


3. The dfsck procedure is useful only if the system is set up for multiple physical I/O 
buffers. 


SEE ALSO 
fsck(1M). 
“Setting up SYSTEM V/68” in the SYSTEM V/68 Administrator's Guide. 


IK (1M) 4 (Motorola Inc. Only) | CHK (1M) 


AME 
chk — check a file system 


"NOPSIS | 

/mot/bin/chk [ disk ][ -y -n ] 

ESCRIPTION 
Chk(1M) checks a file system using fsck(1M). The argument disk and the permissions file are 
used to determine the device to check and whether it should be checked ’-n’ (NO WRITE), 
as when Write permission has not been granted. This device will be the first match of disk 
and the real device or alias entries in the permissions file. If the disk argument is not given 
then the first alias of default in the permissions file will be used. 


Chk actually uses the raw version of the listed real device (by prepending an ’r’ to the name). 


The -y (always answer yes) and -n.(always answer no; i.e. NO WRITE) options are passed to 
fsck if present. They are mutually exclusive. 


‘LES 
/etc/fsck 
/mot/bin/fs 
/mot/etc/perms permissions file 
Z=E ALSO 
fs(4), fsck(1M), perms(4) | 
SYSTEM V/68 Administrator’s Guide. 
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NAME 


chroot — change root directory for a command 
SYNOPSIS 
/etc/chroot newroot command 


DESCRIPTION 
The given command is executed relative to the new root. The meaning of any initial slashes 
(/) in pathnames is changed for a command and any of its children to newroot. Furthermore, 
the initial working directory is newroot. 


Notice that: 

chroot newroot command >x 
will create the file x relative to the original root, not the new one. 
This command is restricted to the superuser. 


The new root pathname is always relative to the current root; even if a chroot is currently in 
effect, the newroot argument is relative to the current root of the running process. 

SEE ALSO 
chdir(2). 

BUGS 


One should exercise extreme caution when referencing special files in the new root file sys- 
tem. 


CLRIC 1M) | ‘CLRIC1M) 


NAME 


SYNOPSIS 


clri — clear inode 


/etc/clri file-system i-number .... 


DESCRIPTION 


Clri writes zeros on the 64 bytes occupied by the inode numbered i-number. File-system 
must be a special filename referring to a device containing a file system. After clri is exe- 
cuted, any blocks in the affected file will show up as missing in an fsck(1M) of the /ile- 
system. This command should only be used in emergencies, and extreme care should be exer- — 
cised. | 


Read and write permission is required on the specified file-system device. The inode becomes 
allocatable. 


The primary purpose of this routine is to remove a file which for some reason appears in no 
directory. If it is used to delete an inode which does appear in a directory, care should be 
taken to track down the entry and remove it. Otherwise, when the inode is reallocated to 
some new file, the old entry will still point to that file. At that point, removing the old 
entry will destroy the new file. The new entry will again point to an unallocated inode; 
therefore, the whole cycle is likely to be repeated again and again. 


SEE ALSO 


BUGS 


fsck(1M), fsdb(1M), ncheck(1M), fs(4).. 


If the file is open, clri is likely to be ineffective. 


CONFIG.68 (1M ) | CONFIG.68( 1M ) 


NAME 
config.68 — configure SYSTEM V/68 


SYNOPSIS 
/etc/config [ —t ] [ —v file ] [ —1 file ] [ —c file ] [ —m file ] dfile 


DESCRIPTION 
Con fig is a program that takes a description of SYSTEM V/68 and generates three files. One 
file provides information regarding the interface between the hardware and device handlers 
(low.s). A second file is a C program defining the configuration tables for the various devices 
on the system (conf.c). A third file contains exception vector assignments (m68kvec.s). 


The —v option specifies the name of the exception vector file; m68kvec.s is the default name. 
The —1l option specifies the name of the hardware interface file; low.s is the default name. 
The —c option specifies the name of the configuration table file; conf.c is the default name. 


The —m option specifies the name of the file that contains all the information regarding sup- 
ported devices; /etc/master is the default name. This file is supplied with SYSTEM V/68 and 
should not be modified unless the user fully understands its construction. 


The —t option requests a short table of major device numbers for character and block type 
devices. This can facilitate the creation of special files. 


The user must supply dfile; it must contain device information for the user’s system. This 
file is divided into three parts. The first part contains physical device specifications. The 
second part contains system-dependent information. The third part contains microprocessor- 
specific information. The first two parts are required, the third part is optional. The format 
and contents of the dfile are provided in d /file(4) in the SYSTEM \/68 User's Manual. To 
obtain an example configuration, the user can run the sysde f(1M) utility. 


¢ FILES 


‘etc’/master default input master device table 
m68kvec.s default output exception vector file for m6Sk 
low.s default output hardware interface file for m68k 
conf.c default output configuration table file 

SEE ALSO | | 


sysdef(1M), dfile(4), master(4). 
“Setting up SYSTEM \'/68” in the SYSTEM WV/68 Administrator's Guide. 


DIAGNOSTICS 
Diagnostics are routed to the standard output and are self-explanatory. 


CPSET( 1M) | _ | CPSET (1M) 


NAME 

cpset — install object files in binary directories 
SYNOPSIS . . 

cpset [—o] object directory [mode owner group] 
DESCRIPTION 


Cpset is used to install the specified object file in the given directory. The mode, owner, and 
group of the destination file may be specified on the command line. If this data is omitted, - 
two results are possible: 
1. If the user of cpset has administrative permissions (i.e., the user’s numerical ID is less than 
100), the following defaults are provided: 


~ mode — 0755 
owner — bin 
group — bin 


2. If the user is not an administrator, the default owner and group of the destination file 
will be that of the invoker. 


An optional argument of —o will force cpset to move object to OLDob ject in the destination 
directory before installing the new object. 


For example: 
cpset echo /bin 0755 bin bin. 
cpset echo /bin 


cpset echo /bin/echo 


All the examples above have the same effect (assuming that the user is administrator). The 
file echo will be copied into /bin and wiil be given 0755, bin, and bin as the mode, owner, 
and group, respectively. 


Cpset utilizes the file /usr/src/destinations to determine the final destination of a file. The 
locations file contains pairs of pathnames separated by spaces or tabs. The first name is the 
“official” destination (e.g., /bin/echo). The second name is the new destination. For example, 
if echo is moved from /bin to /usr/bin, the entry in /usr/src/destinations would be: 


/bin/echo /usr/bin/echo 


When the actual installation is performed, cpset verifies that the “old” pathname does not 
exist. If a file exists at that location, cpset issues a warning and continues. This file does not 
exist on a distribution tape; it is used by sites to track local command movement. The pro- 
cedures used to build the source will be responsible for defining the “official” locations of the 
source. | 


Cross Generation 
The environment variable ROOT will be used to locate the destination file (in the form 
$ROOT/usr/src/destinations). This is necessary in the cases where cross generation is being 
done on a production system. 


SEE ALSO 
install(1M), make(1), mk(8). 
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NA ME 


crash — examine system images 


SYNOPSIS 


/etc/crash [ system ] [ namelist ] 


DESCRIPTION 


Crash is an interactive utility for examining an operating system core image. It has facilities 
for interpreting and formatting the various control] structures in the system and certain mis- 
cellaneous functions that are useful when perusing a dump. 


The arguments to crash are the file name where the system image can be found and a namel- 
ist file to be used for symbol values. 


The default values are /dev/mem and /unix; hence, crash with no arguments can be used to 
examine an active system. If a system image file is given, it 1s assumed to be a system core 
dump and the default process is set to be that of the process running at the time of the crash. 
This is determined by a value stored in a fixed location by the dump mechanism. 


COMMANDS 


Input to crash is typically of the form: 
command [ options |[ structures to be printed | 


When allowed, options modifies the format of the printout. If no specific structure elements 
are specified, all valid entries are used. As an example, proc — 12 15 3 would print process 
table slots 12, 15 and 3 in a long format, while proc would print the entire process table in 
standard format. 


In general, those commands that perform 1/0 with addresses assume hexadecimal on 32-bit 
machines and octal on 16-bit machines. 


The current list of commands includes: 


user [ list of process table entries | 
Aliases: uarea, u_area, u. 
Print the user structure of the named process as determined by the information con- 
tained in the process table entry. If no entry number is given, the information of the 
last executing process is printed. Swapped processes produce an error message. 


trace [—r] [ list of process table entries ] 
Aliases: t. 
Generate a kernel stack trace of the current process. If the —r option is used, the 
trace begins at the saved stack frame pointer in kfp. Otherwise the trace starts at the 
bottom of the stack and attempts to find valid stack frames deeper in the stack. If no 
entry number is given, the information on the last executing process is printed. 


kfp [ stack frame pointer ] 
Aliases: fp. 
Print the start of the current stack frame (set initially from a fixed location in the 
dump) if no argument is given, or set the frame pointer to the supplied value. 


stack [ list of process table entries ] 
Aliases: stk, s, kernel, k. 
Format a dump of the Kernel stack of a process. The addresses shown are virtual sys- 
tem data addresses rather than true physical locations. If no entry number is given, 
the information on the last executing process is printed. 


proc [—{r] ] [ list of process table entries | 
Aliases: ps, p. 
Format the process table. The —r option causes only runnable processes to be printed. 
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The — alone generates a longer listing. 


inode [—] [ list of inode table entries ] 
Aliases: ino, 1. — 
Format the inode table. The — option also prints the inode data block addresses. 


file [ list of file table entries | 
Aliases: files, f. 
Format the file table. 


mount [ list of mount table entries | 
Aliases: mnt, m. 
Format the mount table. 


text [ list of text table entries ] 
Aliases: txt, x. 
Format the text table. 


tty [type] [—] [ list of tty entries ] 
Aliases: term, acia, m400. 
Print the tty structures. The type argument determines which structure is used 
(such as acia). No default type is provided; however, once specified, the last type is 
remembered. The — option prints the stty(1) parameters for the given line. 


stat Print certain statistics found in the dump. These include the panic string (if a panic 
occurred), time of crash, system name, and the registers saved in low memory by the 
- dump mechanism. 


var Aliases: tunables, tunable, tune, v. 
Print the tunable system parameters. 


‘buf [ list of buffer headers | 
Aliases: hdr, bufhdr. 
Format the system buffer headers. 


buffer [ format ][ list of buffers ] 
Alias: b. 
Print the data in a system buffer according to format. If format is omitted, the pre- 
vious format is used. Valid formats include decimal, octal, hex, character, byte, 
directory, inode, and write. The last creates a file in the current directory (see 
“FILES”) containing the buffer data. 


callout 
Aliases: calls, call, c, timeout, time, tout. 
Print all entries in the callout table. 


map [ list of map names ] 
Format the named system map structures. 


nm [ list of symbols ] 
Print symbol value and type as found in the namelist file. 


ts [ list of text addresses ] 
Find the closest text symbols to the given addresses. 


ds [ list of data addresses ] 
Find the closest data symbols to the given addresses. 


od [ symbol name or address ] [ count }[ format ] 
Aliases: dump, rd. 
Dump count data values starting at the symbol value or address given according to 
format. Allowable formats are octal, longoct, decimal, longdec, character, hex, or 
byte. 
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mmu [ process slot number(s) ] 
The mmu command displays the contents of each entry in the mmu_table[ ]. When 
the optional argument is given, the command will display the mmu_table entry asso- 
ciated with the given process slot number. Multiple process slot numbers should be 
separated with blanks. 


! Escape to shel]. 

qd Exit from crash. — 

? Print synopsis of commands. 
ALIASES | 


There are built-in aliases for many of the formats as well as those listed for the commands. 
Some of them are: 


byte b. 
character char, c. 
decimal dec, e. 


directory direct, dir, d. 
hexadecimal hexadec, hex, h, x. 


inode ino , 1. 
longdec Id, D. 
longoct lo, O. 
octal oct, O. 
write Ww. 
FILES 
/usr/include/sys/*.h header files for table and structure info 
/dev/mem default system image file 
/unix default namelist file 
buf.# files created containing buffer data 
SEE ALSO 
mount(1M), nm(1), ps(1), sh(1), stty(1), crash.macs(8). 
BUGS 


Most flags are abbreviated and have little meaning to the uninitiated user. A source listing of 
the system header files at hand would be most useful while using crash. 


Stack tracing of the current process on a running system doesn’t work. 


CRON(1M) — - a | | CRON (1M) 


NAME 
3 cron — clock daemon 


SYNOPSIS 
/etc/cron 


DESCRIPTION | 
Cron executes commands at specified dates and times. Regularly scheduled commands can be 
specified according to instructions found in crontab files; users can submit their own crontab 
file via the crontab(1) command. Commands that are to be executed only once may be sub- 
mitted via the at command. Since cron never exits, it should only be executed once. This is 
best done by running cron from the initialization process through the file /etc/rc . 


Cron only examines crontab files and at command files during process initialization and when 
a file changes. This reduces the overhead of checking for new or changed files at regularly 
scheduled intervals. 


FILES 
/usr/lib/cron main cron directory 
/Susr/lib/cron/log accounting information 
/usr/spool/cron spool area 

SEE ALSO 


at(1), crontab(1), sh(1). 
“Administrative Guidelines” in the SYSTEM V/68 Administrator's Guide. 


DIAGNOSTICS 
A hstory of all actions taken by cron are recorded in /usr/lib/cron/log. 
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‘AME 
crc - a tool to generate cyclic redundancy checksums (crc) of files 


YNOPSIS 
cre [-freld] - | file_list 


IESCRIPTION 
The ere shell command utility is a versatile tool for use in generating 16-bit crc values of an 
input stream. The input stream can consist either of data or of names of files to be checked. 
There are four different display options available. 


If the file to be checked is an object file, cre will ignore the compiler-generated time stamps ~ 
embedded in the file. 


The various options are defined as follows: . 


-f Selects file mode operation. The input stream is interpreted as a list of the names of the 
files to be processed rather than as the data itself. 


-r Selects a raw mode of operation. This option is used mainly to determine if two ver- 
sions of an executable file are exactly the same. This switch causes ere to include the 
compiler-generated time stamps in the coff file image when computing the cre. 


-c Changes the output to include the byte count of each file processed. 
-d Adds the time of the file’s modification to the output. 


-1 Computes the crc in decimal for each line of the input file rather than for the whole file 
itself. Use of this option overrides all others! 


Note that the first four options can be used in any combination. 


There are three general forms of output. The first form is produced without the -c 
option: ~ 


$nnnn for filename (time stamp) 
where $nnnn is the 16-bit checksum in hexadecimal representation; and time stamp is 
‘the time of the file’s modification (displayed if the -d option is Berereoe The fields are 
separated by space (20h) characters. 
The second output form is generated when the -c option is selected: 

$Sunnn length time stamp filename 
where length is the true size of the file, regardless of whether or not raw mode (-r) is 
selected; and time stamp is the time of the file’s modification (displayed if the -d option 


is selected). All fields of this second form are delimited by tab (\t) characters. 


The third form of output is produced by the line mode option (-l). It replaces each line 
of input with its corresponding crc in the form nnnn. 
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DIAGNOSTICS 
crc: bad option letter. - an invalid option letter was specinied: 
crc: argument count. - at least one file name (or ’-’) must be provided. ° 
cre: can't open file for reading. - file cannot be opened for some reason. 
cre: can't read file. - input file cannot be read for some reason. 
EXAMPLES 
Suppose that a touch *; Is -log command produces the following directory isting 
-rwxrwxrwx 1 23 Apr 8 12:39 = apple 
-rwxrwxrwx 1 8307 Apr 8 12:39 peaches 
erwxrwxrwx | 1280 Apr 8 12:39 . pears 
-rwxrwxrwx | 771 Apr 8 12:39 plums 


Note that Is | cre -fde - is equivalent to cre -de . and both would produce output similar to: 


8 12:39:51 1986 


$8AC3 23 Apr apple 
$FD06 8307 Apr 8 12:39:51 1986 peaches 
$C3B0 1280 Apr 8 12:39:51 1986 pears 
$02D2 771 ~=Apr 8 12:39:51 1986 plums 


A means of generating checksums for an entire directory hierarchy is: 
find root_path -type f -print | cre -fcd - 


Use of the ’-type f? option on find is recommended because ere will generate the crc for the 
Girectory, files themselves if presented with their names. . 


You can extract just the cre and length from a stream of crc’s by 1 using the cut command. 
When appended to the above command, 


find args -typef -print| cre -fed -| cut -f1,2 


produces an output of two columns: the crc and the file’s length. 


. FILES 
| /usr/bin/cre 
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“AME 
create - create master release media utility, R3.1 


IESCRIPTION 
The "create" program is designed to be used to create a set of master distribution media for 
application software products. The new version, R3.1, is similar to previous versions, 
although it has been completely re-designed and re-implemented to make it much more 
robust and tolerant of operator errors. 


One new feature of particular interest is the automatic creation of a file containing the crc, 
length, and modification time for each file included on the distribution media. A copy of this 
file is put on the media and transferred to a customer’s system, while another version is 
derived by upgrade for cross-checking purposes. | 


MEDIA CREATED WITH THIS RELEASE OF CREATE CAN 
ONLY BE READ BY R3.1 AND LATER VERSIONS OF UPGRADE! 
OLD VERSIONS OF UPGRADE WON'T WORK. 


All user responses are limited to a specific length; some are limited to a specific set of valid 
responses (shown in the dialogue below in curly braces, eg. {Yes, No}). Any responses that 
exceed the valid internal lengths are truncated. The user is, however, now given the oppor- 
tunity to verify what was entered before creating the media so as to correct any errors before 
they are committed to disk. (Previous versions didn’t allow verification except by running 
Upgrade.) 


Since create is primarily an interactive program, it’s use is explained in the next section by 
examining a typical dialogue that a user would encounter. The last section describes the 
error messages that create produces, divided into most-likely and _least-likely-to-be- 
encountered sections. | 


NTERACTING WITH CREATE | 
This section describes the interactive dialogue that a user encounters when using create. 
Lines shown in boldface typefont represent what the create program displays to the user. 
Text shown in italics is commentary intended to supplement the discussion; it never appears 
on the screen. User responses are underlined; they are examples of what a user might typi- 
cally enter. 


Create is invoked by typing "create" at the system prompt level. 
$ create 
The screen is now cleared via ‘tput clear’ 


Create Master Release Media Utility, R3.1 
Copyright 1984,86 by Motorola Computer Systems, Inc. 


w 


What type of media is this product distributed on? 
{Floppy disk, 1.2MB floppy, Tape cartridge, Cartridge disk, 9-track tape} 
--> XXX . . 
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_ Enter one of these media types here. An invalid input, eg."xxx" shown here, produces 
the message: 


You must enter the first letter of one of the choices and a RETURN, 
or just a RETURN to select the first choice. 


What type of media is this product distributed on? 
{Floppy disk, 1.2MB floppy, Tape cartridge, Cartridge disk, 9-track tape} 
-—>C (identifies a cartridge disk for use) 


If the media needs to be formatted before it can be used, the following questions are 
asked: : 


If you like, I will automatically format the media for you. 
Would you like this? 

{Yes, No} 

“> V 


Enter the shell command needed to format this type of media: 
--> 


The particular command needed here will vary, depending upon the device type, the 
system in use, its configuration, etc. The following virtual device names are normally 
linked to their respective raw device names in /dev, and should be allowable in the 


response: 
/dev/FLOPPY for 640K floppy disk 
/dev/FLOPPY.MB for 1.2MB floppy disk 
/ dev /IOMEGA for 5MB Iomega cartridge disks 


If specified, this command is issued to the shell each time a new volume of media is 
mounted. 


Mount media volume #1, then hit RETURN... 


If automatic | formatting was requested, then the specified format command Is 
displayed now (not shown) as it is invoked. 


What is the name of this product? --> example 
What is this product’s new release identifier? --> EXAMPLE 3.0 


Enter a file name (<11 chars; similar to the product name) for auditing needs 


--> example (#2) 


_ This name is used for auditing purposes and must conform to UNIX file system nam- 
ing conventions. It is a good idea to use some variant of the product’s name here, only 
without any embedded spaces or other funny characters. If illegal characters are — 
entered, the following warning message is displayed and the prompt is re-issued: 


This name must conform to UNIX file naming conventions!!! 
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Enter a file name (<11 chars; similar to the product name) for auditing needs 
--> example 


Enter the pathname for the directory where this product is found 
(yowre now in <name-of-current-working-directory>) 


--> XYZ 


Any absolute or valid relative pathname is legal here. If you’re already in the root 
directory for the product, just enter a" ." (dot). If an invalid directory name is 
entered, eg. the "xyz" shown, then the following message is displayed: 


create: warning -- ‘xyz’ is an invalid directory path!!! 
(errno = 2) 


Enter the pathname for the directory where this product is found 
(you’re now in /usr/local/src/example/common) 
<> , 


(The product’s root pathname is /usr/local/src/example) . 


Into what directory (on the TARGET SYSTEM) should Upgrade copy this product? 
-<-> ° 


This is where the product will be installed in a user’s system when he runs Upgrade. 
A null response is not allowed, and simply causes the prompt to be repeated. There 
are two other types of invalid responses: 


Into what directory (on the TARGET SYSTEM) should Upgrade copy this product? 
--> example (invalid response type 1) 


create: warning -- The target directory name must begin with a ’/" 


Into what directory (on the TARGET SYSTEM) should Upgrade copy this product? 
->/ | (invalid response type 2) 


create: warning -- The target directory name cannot be just ’/”! 


Into what directory (on the TARGET SYSTEM) should Upgrade copy this product? 
--> /d31/stuff/example 


Note that if this directory path doesn’t exist in the USER'S SYSTEM, Ceshine will - 
create it, if possible. 


Enter a command string (<128 chars) to be executed at START of upgrade: 
--> date 3 


This commana, if specified, is simply submitted to the shell by Upgrade before any of 


the product’s files are read from the distribution media. In this example, the date 
command is givén, although any sequence of commands and/or scripts is legal. 
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Enter a command string (<128 chars) to be executed and END of upgrade: 
wan > . 


Similarly, this optional command String is executed by Upgrade after ail of the 
product’s files have been copied into the specified TARGET SYSTEM directory. For 
either command String, a null response is accepted, as in this example. 


Please stand-by for a moment while I figure some things out... 


(nnnn media blocks needed) . 
(deriving an audit file now)... 


As create computes how much space will occupy on the distribution media, the first 

line above is displayed and updated periodically to show its progress. After most of 
the media blocks have been counted, the second line above is displayed while create 
generates.a crc file. When this is done, the first line is redisplayed showing the total 
block count for the media. 


NOTE THAT THE AUDIT FILE DERIVATION CAN TAKE A MINUTE OR MORE! 
BE PATIENT! 


The audit files are placed into the /usr/AUDITS directory for use by Upgrade. 
Specifically, the *.crO file is copied to the distribution media for later installation into 
a user's system for auditing needs. 


When this phase is finished, the screen is cleared via ‘tput clear’. 


Create Master Release Media Utility, R3.1 


This product’s name is ‘example’ 

It’s release identifier iss EXAMPLE 3.0 

(Auditing facilities will use the name: example) 

It is located in the directory rooted at ‘/usr/local/sre/example’. 

It occupies about 292 x 1024-byte disk blocks in the file system, 
and requires 268 (1024-byte) blocks of distribution media. 


The distribution media was specified as Cartridge disk. 
So, 1 volume(s) of this media will be needed to distribute this product. 


| Upgrade will execute this command string prior to installation: 
date 
It will then install the product into the directory named: 
/d3/stuff/ example 
Finally, this command string will be invoked after installation: 
--- none specified --- 


Are these input parameters correct? 


(Yes, No} 


o> 
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At this point, a ’no’ response will allow the user to re-define everything. A ’y’ or null 
response will start the creation of the distribution media. | 


(Note that the byte count shown in the forth line above (1.e.,"292 x 1 024-byte blocks") 
will vary, depending upon whether the file system containing the product's files uses 
512 or 1024 byte blocks -- both create and upgrade automatically detect and adjust 


for any variations here. The distribution media is always written with 1024 byte 
blocks.) 


------ FILE COPY IN PROGRESS ------ 


nnonn blocks written to vol #1 from /usr/local/src/example. 
nnnn blocks being verified on media... 


The above two lines display create’s progress as it copies the product’s files to the 
media (top line), and then as it re-reads the media to verify its integrity. 


In situations where more than one media volume is needed, the following prompt is 
issued after each volume has been filled: 


Mount media volume #n, then hit RETURN... 
Automatic formatting is performed now, if specified (not shown). 


nonn blocks written to volume #n from <source_directory>... 
nnnn blocks being verified on media... 


and so on, until the entire product has been written to media. 
Now creating an audit file for this product... 
Finished creating master(s) for ‘example (EXAMPLE 3.0). 


(A table-of-contents listing of this product with cre’s is contained in: 
‘<audit_file_ name>’ 


Do you wish to create a master copy of another product? | 
{No, Yes} 
-—>, - 


If you’re done, you can just hit RETURN now. 


$ This ends the example dialog! 


ITAGNOSTICS | 
Most parameters are validated before being committed for use, either by the program or by 
the user via the status display. It is possible, however, for an internally executed shell.com- 
mand to die, in which case an error message may or may not be produced. Known error con- 
ditions fall into two categories: warnings and fatal errors. Warnings produce a message, but 
allow for continued execution. Fatal errors include any error that would prevent a complete 
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creation of the distribution media. The defined warning and fatal error messages are 
enumerated below. 7 


Note that if the /usr/bin/cre program is missing, create should be aborted and re-run a 
erc is located and installed. 


--- WARNING MESSAGES --- 
Warnings likely to be encountered: 


The target directory name must begin with a ’/’ 
The target directory cannot be just a’/’ 

The media failed verification 

‘<pathname>’ is an invalid directory path 


Warnings unlikely to be encountered: 


can’t determine size of audit file 
can’t read/verify end-of-volume flag from media 
can’t read/verify checksum block from media 


--- FATAL ERROR MESSAGES --- 
Fatal errors likely to be encountered: 


You must be logged in as root or have root’s setuid permission set! 
Fatal errors unlikely to be encountered: 


can’t open device {<dev_name>} for writing 

error encountered while writing header info 

error writing to output media : 

error reading from input data stream 

error encountered while writing end-of-volume flag 
error encountered while writing checksum to.the media 
unable to open output media for reading 

error encountered while reading header 

error occurred attempting to read data from media 
The end-of-volume flag block is corrupted 

cannot chdir to ’<source_root_directory>’ 


FILES 
tput 
/usr/bin/cre 
/usr/AUDITS/* 


SEE ALSO .-_s- | 
upgrade(1M), tput(1M), crce(1M), create(4) 
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NAME 


dcopy — copy file systems for optimal access time 


SYNOPSIS 


/etc/dcopy [—sX] [—an] [—d] [—v] [—ffsizesisize] inputfs outputfs 


DESCRIPTION 


Dcopy copies file system input fs to output fs. Input fs is the existing file system; out put fs is 
an appropriately sized file system, to hold the reorganized result. For best results input fs 
should be the raw device and out put fs should be the block device. Dcopy should be run on 
unmounted file systems (in the case of the root file system, copy to a new pack). With no 
arguments, dcopy copies files from inputfs compressing directories by removing vacant 
entries, and spacing consecutive blocks in a file by the optimal rotational gap. The possible 
options are: 


—sxX supply device information for creating an optimal organization of blocks in a file. 
The forms of X are the same as the —s option of fsck(1M). 


—an place the files not accessed in n days after the free blocks of the destination file 
system (default for n is 7). If no n is specified then no movement occurs. 


—d leave order of directory entries as is (default is to move sub-directories to the 
beginning of directories). 


SAN reports how many files were processed, and how big the source and destination 
freelists are. 

=f /. sizeltisize | | 
specify the out put fs file system and inode list sizes (in blocks). If the option (or 
isize) is not given, the values from the input fs are used. 


Deopy catches interrupts and quits and reports on its progress. To terminate dcopy, send a 
quit signakand dcopy will no longer catch interrupts or quits. Dcopy also attempts to modify 
its commandline arguments so its progress can be monitored with ps(1). 


SEE ALSO 


BUGS 


fsck(1M), mkfs(1M), ps(1). 


If a non-zero length fifo file (named pipe) is present on the input (source) file system, the out- 
put (target) file system will be corrupted. To work around this problem, find the fifo file on 
the input file system and either delete it or zero it out. The error that fsck finds on the out- 
put file system is a duplicate block error, which will require elimination of files on that file 
system to correct. Under normal circumstances this error should not be encountered, because 
a fifo file goes to zero length if no processes have it open, which is the usual case if the input 
file system can be unmounted. 
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NAME 


dcpy — copy file systems for optimal access time 
SYNOPSIS | 

/mot/bin/dcpy in-alias out-alias 
DESCRIPTION : 


Dcpy uses the permissions file to change in-alias ( a block device ) and out-alias ( a block 
device ) into inputfs and outputfs. Dcpy then copies file system inputfs to outputfs. Inputfs is 
the existing file system; outputfs is a file system appropriately sized to hold the reorganized 
result. Dcpy uses the fsize parameter in the permissions file for the size of the file system on 
outputfs. Dcpy should be run on unmounted file systems (in the case of the root file system, 
copy to a new pack). With no arguments, dcpy copies files from inputfs, compressing direc- 
tories by removing vacant entries, and spacing consecutive blocks in a file by the optimal 
rotational gap. Dcpy places files not accessed in 7 days after the free blocks of outputfs. 
Dcpy moves subdirectories to the beginning of directories. Dcpy catches interrupts and quits 
and reports on its progress. To terminate dcpy, send a quit signal, and dcpy will no longer 
catch interrupts or quits. 


FILES 

/etc/dcopy 

/mot/bin/dcpy 

/mot/etc/perms permission file 
SEE ALSO 

dcopy(1M), fsck(1M), mkfs(1M), ps(1). 
BUGS 


If a non-zero length fifo file (named pipe) is present on the input (source) file system, the 
output (target) file system will be corrupted. To work around this problem, find the fifo file 
on the input file system and either delete it or zero it out. The error that fsck(1M) finds on 
the output file system is a duplicate block error, which will require elimination of files on 
that file system to correct. Under normal circumstances this error should not be encoun- 
tered, because a fifo file goes to zero length if no processes have it open, which is the usual 
case if the input file system can be unmounted. 
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NAME 

devnm — device name 
SYNOPSIS 

/etc/devnm [ names | 
DESCRIPTION 


Devnm identifies the special file associated with the mounted file system where the argument 
name resides. (As a special case, both the block device name and the swap device name are 
printed for the argument name / if swapping is done on the same disk section as the root file 
system.) Argument names must be full pathnames. 


This command is most commonly used by /etc/rc (see bcheckrc(1M)) to construct a mount 
table entry for the root device. 


EX AMPLE 
The command: 
/etc/devnm /usr 
produces 
dsk/cnirlr_1s0 /usr 
if /usr is mounted on /dev/dsk/cntrir_1s0. 


FILES 
/dev/dsk/* 
/etc/mnttab 


SEE ALSO 
bcheckrc(1M), setmnt( 1M). 
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NAME 
df — report number of free disk blocks 
SYNOPSIS 
df { —t ] [ —f ] [ file-systems ] 
DESCRIPTION | . 


Df prints out the number of free blocks and free inodes available for online file systems by 
examining the counts kept in the super-blocks; file-systems may be specified either by device 
name (e.g, /dev/dsk/cntrir_0s1) or by mounted directory name (e.g. /usr). If the /file- 
systems argument is unspecified, the free space on all of the mounted file systems is printed. 


The —t flag causes the total allocated block figures to be reported as well. 


If the —f flag is given, only an actual count of the blocks in the free list is made (free inodes 
are not reported). With this option, df reports on raw devices. 


FILES 
/dev/dsk/* 
/etc/mnttab 


SEE ALSO 
fs(4), mnttab(4). 
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NAME 
dinit — disk initializer 
SYNOPSIS | 

/etc/dinit [—force] [-T] [—d desc] [—b file] [-t file] type rdev 


YESCRIPTION 
Dinit can be. used to initialize specified disk types. The type must be one from the file 
/etc/diskdefs. Current values are shown in the following tables: 


VM21 CONTROLLER 


50Mb Lark Module Drive vm2 llark25 
16Mb Lark Module Drive vm2 llark8 
80Mb Cartridge Module Drive vm21cmd80 
16Mb Cartridge Module Drive vm21cemd16 
Double-sided 8" Floppy Diskette vm2I1dssd8 
Single-sided 8" Floppy Diskette vm2 Isssd8 


VM22 CONTROLLER 


Removable 25Mb Lark vm22R25L 
Fixed 25Mb Lark vm22F25L 
Removable 8Mb Lark vm22R8L 
Fixed 8Mb Lark vm22F8L 
Removable 16Mb Cmd vm22R 16C 
Fixed 16Mb CMD | vm22F16C 
Fixed 80Mb CMD | vm22F80C 
*Double-sided Double Density 8" Floppy vm22dsdd8 
*Single-sided Double Density 8" Floppy vm22ssdd8 
*Double-sided Single Density 8" Floppy vm22dssd8 
*Single-sided Single Density 8" Floppy vm22sssd8 
**Double-sided Double Density 534' Floppy vm22dsdd5 
**Single-sided Double Density 5 44' Floppy vm22ssdd5 
**Double-sided Single Density 5 ¥4' Floppy vm22dssd5 
**Single-sided Single Density 5 14’ Floppy vm22sssd5 
* Motorola 8" Format 
_ ** TBM 5 4' Format 


MVME319 CONTROLLER (ID CONTROLLER) 


40Mb Micropolis Winchester idwm40 
**Double-sided Double Density 5 ¥4' Floppy iddsdd5 
*Double-sided Single Density 8" Floppy iddssd8 
*Cipher Data Products CT525 FloppyTape _ -idftape 
* Motorola 8" Format 

** TBM 5 14' Format 


w 
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MVME320 CONTROLLER ° 


Drive Name j type Value 


40Mb Vertex Winchester m32040v 


15Mb Computer Memories Winchester m32015 
40Mb Micropolis Winchester m32040m 
70Mb Micropolis Winchester m32070m 
40Mb Miniscribe Winchester m32040s 
40Mb Toshiba Winchester m32040t 
70Mb Toshiba Winchester m32070t 
70Mb Priam Winchester m32070p 
140Mb MAXTOR Winchester m320140 


**Double-sided Double Density 5 U' Floppy _m320dsdd5 


** TBM 5 \4' Format 


MVME360 CONTROLLER 


For disk types with software or hardware bad track handling, the alternate track numbers 
will be taken from the file /etc/diskalts/type, where type is the type name given in 
/etc/diskdefs. If no file /etc/diskalts/type exists, the user will be prompted to enter the alter- 
nate track numbers interactively. There is no software bad track support for floppy diskettes. 


The rdev argument specifies a raw device, which must be of the form /dev/rstring. There 
must be a corresponding block device /dev/string with the same minor device number as the 
character device. Dinit must be executed over slice 7 of the raw device. 


The following options are provided for dinit: 


—f 


—f 


—C 


—¢€ 


—d desc 
—b file 
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Format disk. When formatting an unformatted disk, two read errors appear on the 
screen. These errors occur because the controller is trying to read configuration 
information from the disk. The messages can be ignored; the disk will be format- 
ted as requested. 


Override disk contents, including type and bad tracks. 


Read the current bad track list from the disk. By default, it is printed in <head> 
<cylinder> format. If the —T option is in effect, track numbers are printed instead. 
The actual list is printed to standard output, the header to standard error. 


Check for new bad tracks. A read/write pass is executed for each track on the 
device. If a read or write error occurs for a track, the track number is stored in a 
list of bad tracks for the device (if —o was NOT specified, it is added to the 
current list read from the device). After the pass, any new bad tracks found are 
printed. As with —r above, the format of the list is controlled by the —T option. 
Use EXORMACS instead of MOTOROLA in sector 0, for compatibility with 
VYVMO3 and EXORmacs bootloaders. 


Use desc as description string in sector 0. 
Use file (a.out format) as the bootloader program. 
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XAMPLE 


—t file Take bad track information from file, instead-of interactively. By default, file is 
assumed to contain some number of lines of the form: 


head cylinder 


indicating the location of manufacturer specified defects. If, however, the —T 
option is in effect, the file is assumed to contain track numbers. 


Unless the —f or —o options are given, dinit will examine the disk to ensure the disk type is 
not being changed (i.e. from m32070m to m32070t). Also, it will read the previous bad track 
list. Therefore, it is not necessary to re-enter bad track numbers on subsequent use of dinit 


on a disk. This is useful for changing the bootloader, description string, etc. (For calcula- | 


tions of bad track numbers, refer to the specific format utility, e.g., ™320fmt(1M).) 
Whenever new bad tracks are given to dinit, the layout of the areas of the disk provided for 


file systems may be arbitrarily remapped. Therefore, all useful information from the disk 


should be copied to backup media before adding bad tracks and then copied back when dinit 
has finished. 


/etc/dinit -f -o -t /etc/badtracks/00 -b /stand/m68k/boots/ymeboot m32070m /dev/r00s7 


This command formats the first 70MB disk attached to the first MVME320 controller using a 
disk defect list entered into /etc/badtracks/00. All data on the disk is destroyed. The disk 
contains a bootloader file that will boot the operating system after it is installed. Note: This 


particular command could only be run while booted on a floppy or winchester drive other 
than 00. 


ILES 
/etc/diskdefs disk definition file 
/etc/diskalts/* alternate track numbers 
EE ALSO 


m320fmt(1M) 
SYSTEM V/68 Administrator’s Guide. 
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NAME 
diskusg — generate disk accounting data by user ID 


SYNOPSIS 
/usr/lib/acct/diskusg [options] [files] 


DESCRIPTION 
Diskusg generates intermediate disk accounting information from data in files, or the standard 
input if the files argument is omitted. Diskusg outputs lines on the standard output, one per 
user, in the following format: 


uid login #blocks 
where 


uid is the numerical user ID of the user; Jogin is the login name of the user; and #blocks is the 
total number of disk blocks allocated to this user. 


Diskusg normally reads only the inodes of file systems for disk accounting. In this case, files 
are the special filenames of these devices. 


Diskusg recognizes the following options: 


—S The input data is already in diskusg output format. Diskusg combines all lines 
for a single user into a single line. 
—v Verbose. Print a list on standard error of all files that are charged to no one. 


—ifnmilist Ignore the data on those file systems whose file system name is in fnmiist. 
Fnmilist is a list of file system names, separated by commas or enclosed within 
quotes. Diskusg compares each name in this list with the file system name 
stored in the volume ID (refer to labelit in volcopy(1M)). For example, sites that 
want to account only for disk blocks allocated to non-administrative users can 
use the —i option to ignore certain file systems, e.g., root and usr. In this case, 
the administrator should use the fsname field reported by labelit as the argu- 
ments of the —i option to diskusg in the shell script dodisk. To ignore root and 
usr, line 31 in dodisk would be changed to: 

diskusg —i root,usr S$args > dtmp 


—pfile Use file as the name of the password file to generate login names. The file 
/etc/passwd is used by default. 
—ufile Write records to file of files that are charged to no one. Records consist of the 


special filename, the inode number, and the user ID. 


The output of diskusg is normally the input to acctdisk (refer to acct(1M)) which generates 
total accounting reocrds that can be merged with other accounting records. Diskusg is nor- 
mally run in the shell script dodisk (refer to acctsh(1M)). Note that in previous releases the 
disk blocks of a file were charged to the user whose login directory hierarchy contained the 
file. In the current release, diskusg charges disk blocks to the file’s owner. This change may 
result in slightly different disk block usage reports when run on the same data. The previous 
method of disk accounting may be invoked with the —o option of dodisk. 


EXAMPLES 
The following will generate daily disk accounting information: 


for iin /dev/rp00 /dev/rp01 /dev/rp10 ali ae do 


diskusg $i > dtmp.‘basename $i‘& 
done 


Pe 


DISK USG(1M) | DISK USG(1M) 


wait 

diskusg —s dtmp.* | sort +0n +1 | acctdisk > disktacct 
FILES 

/etc/passwd used for conversions of user ID to login name 
SEE ALSO | | 


acct(1M), acctsh(1M), acct(4). 
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NAME 

errdead — extract error records from dump 
SYNOPSIS 

/etc/errdead dumpfile [ namelist ] 
DESCRIPTION 


When hardware errors are detected by the system, an error record that contains information 
pertinent to the error is generated. If the error-logging daemon errdemon(1M) is not active or 
if the system crashes before the record can be placed in the error file, the error information is 
held by the system in a local buffer. Errdead examines a system dump (or memory), extracts 
such error records, and passes them to err pt(1M) for analysis. 


The dumpfile specifies the file (or memory) that is to be examined. The system namelist is 
specified by namelist; if not given, /unix is used. 


FILES 
/unix system namelist 
/usr/bin/errpt analysis program 
/usr/tmp/errXXXXXX temporary file 
DIAGNOSTICS 


Diagnostics may come from either errdead or errpt. In either case, they are self-explanatory. 


SEE ALSO 
errdemon(1M), errpt(1M). 
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NAME 
errdemon -— error-logging daemon 
SYNOPSIS 
 /usr/lib/errdemon [ file ] 
DESCRIPTION 


The error logging daemon errdemon collects error records from the operating system by read- 
ing the special file /dev/error and places them in file. If file is not specified when the dae- 
mon is activated, /usr/adm/errfile is used. Note that file is created if it does not exist; other- 
wise, error records are appended to it, so that no previous error data is lost. No analysis of 
the error records is done by errdemon; that responsibility is left to errpt(1M). The error- 
logging daemon is terminated by using errstop (see errstop(1M)). Only the superuser may 
start the daemon, and only one daemon may be active at any time. 


FILES 
/dev/error source of error records 
/usr/adm/errfile repository for error records 


DIAGNOSTICS | 
The diagnostics produced by errdemon are self-explanatory. 


SEE ALSO | 
errpt(1M), errstop(1M), kill(1), err(7). 
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NA ME 


errpt — process a report of logged errors 


SYNOPSIS 


errpt [ options ] [ files ] 


DESCRIPTION 


FILES 


Errpt processes data collected by the error logging mechanism (errdemon(1M)) and generates 
a report of that data. The default report is a summary of all errors posted in the files named. 
Options apply to all files and are described below. If no files are specified, errpt attempts to 
use /usr/adm/errfile as file. 


A summary report notes the options that may limit its completeness, records the time stamped 
on the earliest and latest errors encountered, and gives the total number of errors of one or 
more types. Each device summary contains the total number of unrecovered errors, recovered 
errors, errors unabled to be logged, I/O operations on the device, and miscellaneous activities 
that occurred on the device. The number of times that errpt has difhiculty reading input data 
is included as read errors. 


Any detailed report contains, in addition to specific error information, all instances of the error 
logging process being started and stopped, and any time changes (via date(1)) that took place 
during the interval being processed. A summary of each error type included in the report is 
appended to a detailed report. 


A report may be limited to certain records in the following ways: 


—s date Ignore all records posted earlier than date, where date has the form 
mmddhhmmyy, consistent in meaning with the date (1) command. 


—e date Ignore all records posted later than date, whose form is as described above. 
—a Produce a detailed report that includes all error types. 


—d deviist A detailed report is limited to data about devices given in devlist, where 
| devlist can be one of two forms: a list of device identifiers separated from 
one another by a comma, or a list of device identifiers enclosed in double 
quotes and separated from one another by a comma and/or more spaces. 
Err pt is familiar with the common form of identifiers. For the EXORmacs, 
the device for which errors are logged is ud(7). For the VME/10, the device 
is wd(7). For 3B20S, the devices are DFC, IOP, and MT. For Digital Equip- 
ment Corporation machines, the (block) devices for which errors are logged 
are RPO3, RPO4, RPOS, RP0N6, RPO7, RSO3, RSO4, TS11, TU10, TU16, TU78, RKOS, 
RK06, RKO7, RMOS, RM8O, and RF11. Additional identifiers are int and mem 
which include detailed reports of stray-interrupt and memory-parity type 
errors respectively. 


—prn Limit the size of a detailed report to n pages. 


—f In a detailed report, limit the reporting of block device errors to unrecovered 
errors. 


/usr/adm/errfile default error file 


SEE ALSO 


errdead(1M), errdemon(1M), errfile(4), date(1). 
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NAME | 
errstop — terminate the error-logging daemon 
SYNOPSIS 
/etc/errstop [ namelist ] 
DESCRIPTION 


The error-logging daemon errdemon(1M) is terminated by using errstop. This is accomplished 
by executing ps(1) to determine the daemon’s identity and then sending it a software kill 
signal (see signal(2)); /umix is used as the system namelist if none is specified. Only the 
superuser may use errstop. 


FILES 

/unix default system namelist 
DIAGNOSTICS 

The diagnostics produced by errstop are self-explanatory. 
SEE ALSO | | 


errdemon(1M), ps(1), kill(2), signal(2). 


FF(1M) FF( 1M) 


NAME 
ff — list filenames and statistics for a file system 
SYNOPSIS 
/etc/ff [options] special 
DESCRIPTION 
Ff reads the i-list and directories of the special file, assuming it to be a file system, saving 
inode data for files that match the selection criteria. Output consists of the pathname for each 
saved inode, plus any other file information requested (refer to the print options below). Out- 
put fields are positional. The output is produced in inode order; fields are separated by tabs. 
The default line produced by ff is: 
pathname i-number 
With all options enabled, output fields would be: 
pathname i-number size uid 
The argument n in the option descriptions that follow is used as a decimal integer (optionally 
signed), where +n means more than n, —n means less than n, and n means exactly n. A day 
is defined as a 24-hour period. 
—IJ | Do not print the inode number after each pathname. 
—] Generate a supplementary list of all pathnames for multiple linked files. 
—p pre fix The specified pre fix is added to each generated pathname. The default is... 
—s Print the file size, in bytes, after each pathname. | 
—U Print the owner’s login name after each pathname. 
—an Select if the inode has been accessed in n days. 
—m n Select if the inode has been modified inn days. 
=n Select if the inode has been changed in n days. 
—n file Select if the inode has been modified more recently than the argument file. 
—1 inode-list | Generate names for only those inodes specified in inode-list. 
EX AMPLES | 
To generate a list of the names of all files on a specified file system: 
ff —I /dev/diskroot 
To produce an index of files and i-numbers that are on a file system and have been modified 
in the last 24 hours: 
ff —m —1 /dev/diskusr > /log/incbackup/usr/tuesday 
To obtain the pathnames for inodes 451 and 76 on a specified file system: 
ff —i 451,76 /dev/rdsk/cntrir_1s0 
SEE ALSO | 
finc(1M), find(1), frec(1M), ncheck(1M). 
BUGS 


Only a single pathname is generated for a multiply linked inode, unless the —1 option is speci- 
fied. When —1 is specified, no selection criteria apply to the names generated; all possible 
names for every linked file on the file system are included in the output. 


On very large file systems, memory may run out before // does. 


FILESAVE( 1M) | FILESAVE(1M) 


NAME 

filesave, tapesave — daily/weekly SYSTEM V/68 file system backup 
SYNOPSIS 

/etc/filesave.? 

/etc/tapesave 


DESCRIPTION 
These shell scripts are provided as models. They are designed to provide a simple, interactive 
operator environment for file backup. Filesave. is for daily disk-to-disk backup, and 
tapesave is for weekly disk-to-tape. 


The suffix .? can be used to name another system where two (or more) machines share disk 
drives (or tape drives) and one or the other of the systems is used to perform backup on both. 


SEE ALSO 
shutdown(1M), volcopy(1M). 


INC(1M) | ) - -FINC(1M) 


[AME | 3 
finc — fast incremental backup 


YNOPSIS 
fine [selection-criteria] file-system raw-tape 


'ESCRIPTION | | 
Finc selectively copies the input file-system to the output raw-tape . Mount the input /file- 
system read-only to insure an accurate backup, although acceptable results can be obtained in 
read-write mode. The tape must be previously labelled by labelit (see volcopy(1M)). The 


selection is controlled by the selection-criteria, accepting only those inodes/files for whom the 
conditions are true. 


It is recommended that production of a finc tape be preceded by the f/f command, and the 
output of ff be saved as an index of the tape’s contents. Files on a finc tape may be 
recovered with the frec command. 


The argument n in the selection-criteria which follow is used as a decimal integer (optionally 
signed), where +7 means more than n, —n means less than n, and n means exactly n. A day is 
defined as 24 hours. 


—an True if the file has been accessed in n days. 
—m 7 True if the file has been modified in n days. 
—Cn True if the inode has been changed in n.days. 
—n file True for any file which has been modified more recently than the argument 
file. | 
XAMPLES 


To write a tape consisting of all files from file-system /usr modified in the last 48 hours: 
finc —m —2 /dev/rdiskusr /dev/rmt/cnirir_Om — 
Z=E ALSO 
cpio(1), ff(1M), frec(1M), volcopy(1M). 
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FMT(1M) | ' (Motorola Inc. Only) a FMT (1M) 


NAME 
format — disk- initializer 

SYNOPSIS 
/mot/bin/fmt [ options ] alias 

DESCRIPTION | | 
Fmt(1M) checks to see that alias is in the permissions file and that format permission is given. 
It then lists the action it is going to take (i.e. what program it is going to execute over what 
device) and asks for confirmation. Any character other than ’y’ is taken as a negative 
response and no action is taken. Otherwise, fmt(1M) passes on any options given and slice 7 
of the raw device found in the permissions file to the format-program specified in the permis- 
sions file. 


FILES 
/etc/diskdefs disk definition file 
/etc/diskalts/* alternate track numbers 
/etc/dinit 
/mot/bin/fs | 
/mot/etc/perms permissions file - 


SEE ALSO 
dinit(1M), 
SYSTEM V/68 Administrator’s Guide. 
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"REC(1M) a | FREC(1M) 


{AME . 
frec — recover files from a backup tape 


YNOPSIS 
/etc/frec [—p path] [—f reqfile ] raw-tape i-number:name ... 


YESCRIPTION 
Frec recovers files from the specified raw-tape backup tape written by volcopy(1M) or 
finc(1M), given the i-numbers. The data for each recovery request is written into the file 
given by name. 


The —p option allows specification of a default prefixing path different from the current 
working directory. This is prefixed to any names that are not fully qualified, i.e., that do not 
begin with / or ./. If any directories are missing in the paths of recovery names, they are 


created. 
—p path Specifies a prefixing path to be used to fully qualify any names that do not 
start with / or ./. 
—f regfile Specifies a file which contains recovery requests. Using only one entry per 
line, the format is: i-number-:newname 
XAMPLES 


To recover file i-number 1216, when backed up into a file named junk in your current work- 
ing directory: 


frec /dev/rmt/cnirl_m0 1216:junk 


To recover files with i-numbers 14156, 1232, and 3141 into files /usr/src/emd/a, 
— /usr/src/emd/b and /usr/drane/a.c: . 


frec —p /usr/src/cmd /dev/rmt/cnirir_m0 14156:a 1232:b 3141:/usr/drane/a.c 
ZE ALSO 

cpio(1), ff(1M), fine(1M), volcopy(1M). 
UGS 


While creating the intermediate directories contained in a pathname, frec can only recover 
inode fields for those directories contained on the tape and requested for recovery. 
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FS( 1M) 3 | (Motorola Inc. Only) —— FS( IM) 


NAME . 
.fs — construct a file system 


SYNOPSIS 
 f{mot/bin/fs [ disk [ blocks[:inodes] ] ] 


DESCRIPTION 
Fs(1M) builds a file system with a single empty directory on it. The argument disk and the 
permissions file are used to determine the device to build a file system on. This device will 
be the first match of disk and the real device or alias entries in the permissions file. If the 
disk argument is not given then the first alias of default in the permissions file will be used. 


Fs actually uses the raw version of the listed real device (by prepending an ’r’ to the name). 


The size of the file system is the value of blocks interpreted as a decimal number. This is the 
number of physical disk blocks the file system occupies. This value may not be larger than 
the default value specified in the permissions file. If the number of blocks is not specified the 
default value in the permissions file is used. The boot program is left uninitialized. If the 
optional number of inodes is not given, the default is the number of logical blocks divided by 
four. 


FILES 
/etc/mkfs 
/mot/bin/fs 
/mot/etc/perms permissions file 
SEE ALSO 
dir(4), fs(4), mkfs(1M), perms(4) 
SYSTEM V/68 Administrator's Guide. 
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NAME 
fsba — file system block analyzer 
SYNOPSIS 
fsba file-system ... 
DESCRIPTION 
Fsba determines the number of extra sectors (1 sector has 512 bytes) needed when the file 


system logical block size is increased from 512 bytes per block to 1024 bytes/block. File- 
system should be specified by device name (e.g., /dev/dsk/cntrir_1s1). 


Fsba determines how many sectors are currently allocated for the 512 bytes/block file sys- 
tem, and how many sectors are required for the 1024 bytes/block converted file system. 
Fsba also prints out the number of allocated and free inodes for each file-system. 


If the number of free sectors for the 1024 bytes/block file system is negative, the file system 
is too large to convert to 1024 bytes/block. 


SEE ALSO 
fs(4). 


FSCK (1M) | | | FSCK (1M) 


NAME 
fsck, dfsck — file system consistency check and interactive repair 


SYNOPSIS - 
/etc/fsck [—y] [—n] [—sx] [—sx] [—+ file] [—q] [—pb] [—f£] [ file-systems ] 


/etc/dfsck [ options! ] filsys1 ... — [ options2 ] filsys2 ... 


DESCRIPTION 
Fsck 

F’sck audits and interactively repairs inconsistent conditions for SYSTEM V/68 files. If the file 
system is consistent then the number of files, number of blocks used, and number of blocks 
free are reported. If the file system is inconsistent, the operator is prompted for concurrence 
before each correction is attempted. It should be noted that most corrective actions result in 
some loss of data. The amount and severity of data lost may be determined from the diagnos- 
tic output. The default action for each consistency correction is to wait for the operator to 
respond yes or no. If the operator does not have write permission fsck defaults to a —n 
action. 


F’sck has more consistency checks than its predecessors check, dcheck, fcheck, and icheck 
combined. 


The following options are interpreted by fsck. 
—y Assume a yes response to all questions asked by fsck. 


—n Assume a no response to all questions asked by fsck; do not open the file system for 
writing. 


—sX Ignore the actual free list and (unconditionally) reconstruct a new one by rewriting the 
superblock of the file system. The file system should be unmounted while this is done; 
if this is not possible, care should be taken that the system is quiescent and that it is 
rebooted immediately afterwards. This precaution is necessary so that the old, bad, in- 
core copy of the superblock does not continue to be used, or written on the file system. 


The —sX option allows for creating an optimal free-list organization. The following 
forms of X are supported for the following devices: 
—sBlocks-per-c y linder:Blocks-to-skip 


If X is not given, the values used when the file system was created are used. If these 
values were not specified, then the value 40027 is used. 


—SX Conditionally reconstruct the free list. This option is like —sX above, except that the 
free list is rebuilt only if there were no discrepancies discovered in the file system. 
Using —S forces a no response to all questions asked by fsck. This option is useful for 
forcing free list reorganization on uncontaminated file systems. 


—t If fsck cannot obtain enough memory to keep its tables, it uses a scratch file. If the —t 
option is specified, the file named in the next argument is used as the scratch file, if 
needed. Without the —t flag, fsck prompts the operator for the name of the scratch 
file. The file chosen should not be on the file system being checked, and if it is not a 
special file or did not already exist, it is removed when /sck completes. 


—q Quiet fsck. Do not print: size-check messages in Phase 1. Unreferenced fifos are 
silently removed. If fsck requires it, counts in the superblock are automatically fixed 
and the free list salvaged. 


—D Directories are checked for bad blocks (useful after system crashes). 


—f Fast check. Check block and sizes (Phase 1) and check the free list (Phase 5). The free 
list is reconstructed (Phase 6) if it is necessary. 3 
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If no file-systems are specified, fsck reads a list of default file systems from the file 
/etc/checklist. 


Inconsistencies checked are as follows: 


1. Blocks claimed by more than one inode or the free list. 

2 Blocks claimed by an inode or the free list outside the range of the file system. 
3 Incorrect link counts. 

4 Size checks: 


Incorrect number of blocks. 
Directory size not 16-byte aligned. 
Bad inode format. 
Blocks not accounted for anywhere. 
Directory checks: 
File pointing to unallocated inode. 
Inode number out of range. 
8. Super Block checks: 
More than 65536 inodes. 
More blocks for inodes than there are in the file system. 
9. Bad free block list format. 
10. Total free block and/or free inode count incorrect. 


Poe ahd 


Orphaned files and directories (allocated but unreferenced) are, with the operator’s con- 
currence, reconnected by placing them in the lost+found directory, if the files are not empty. 
The user is notified if the file or directory is empty or not. If it is empty, fsck silently 
removes it. F’sck forces the reconnection of directories which are not empty. The name 
assigned is the inode number. The only restriction is that the directory lost+found must 
pre-exist in the root of the file system being checked and must have empty slots in which 
entries can be made. This is accomplished by making lost+found, copying a number of files 
to the directory, and then removing them (before fsck is executed). 


Checking the raw device is almost always faster and should be used with everything but the 
root file system. 


Dfsck 


FILES 


Dfsck allows two file system checks on two different drives simultaneously. Options] and 
options2 are used to pass options to fsck for the two sets of file systems. A — is the separator 
between the file system groups. 


The dfsck program permits an operator to interact with two fsck(1M) programs at once. To 
aid in this, dfsck prints the file system name for each message to the operator. When answer- 
ing a question from dfsck, the operator must prefix the response with a 1 or a 2 (indicating 
that the answer refers to the first or second file system group). 


Do not use d fsck to check the root file system. 


/etc/check list contains default list of file systems to check. 
/etc/checkall optimizing dfsck shell file. 


SEE ALSO 


BUGS 


checkall(1M), clri(1M), ncheck(1M), checklist(4), fs(4), crash.macs(8). 
“Setting up SYSTEM V/68” in the SYSTEM V/68 Administrator's Guide. 


Inode numbers for . and .. in each directory should be checked for validity. 
Unless explicitly called with the —n flag, fsck will automatically clear unreferenced inodes. 
This will damage a mounted file system. 


DIAGNOSTICS 


The diagnostics produced by fsck are self-explanatory. 


FSCV (1M) a | FSCV(1M) 


NAME 


fscv — convert files between M68000 and VAX-11/780 processors 


SYNOPSIS 


/etc/fscv —v ispecial [ ospecial ] 
/etc/fscv —m ispecial [ ospecial ] 


DESCRIPTION : 


Fscv converts file systems between M68000 and VAX-11/780 formats. The super block, free 
list, and inodes are converted to the format of the output file. Fscv may be executed on 
M68000 and VAX processors. The mandatory flag specifies the format of the converted file 
system: 


—v Convert file system from M68000 to VAX format. 
—m Convert file system from VAX to M68000 format. 


Ispecial is the name of a special file containing a file system to be converted (eg. 
/dev/rdsk/cntrir_1s0). The optional ospecial is the name of the special file to receive the 
results of the conversion. If ospecial is specified, the entire contents of is pecial are copied to 
oSpecial before the conversion is performed. If ospecial is not specified, an in-place conversion 
of ispecial is performed. The following items should be noted before executing fscv: 


1. A file system consistency check (fsck(1M)) should be performed on ispecial immedi- 
ately prior to executing /fscv. 


om Neither ispecial nor the optional os pecial should contain a mounted file system during 
execution of fscv. Modification to either the input or the output file system while 
fscv is executing will probably corrupt the converted file system. 


3. A backup of ispecial (see volcopy(1M)) is highly recommended if an in-place conver- 
sion is to be performed. System crashes, I/O errors, etc., during execution of fscv may 
destroy the file system contained in ispecial. Also, if the optional ospecial is specified, 
any data contained in that special file is over written. — 


4, If the optional os pecial is specified, this special file must be large enough to contain the 
entire contents of is pecial. See the appropriate special files in section 4. 


EXAMPLES 


Copy and convert a file system from M68000 to VAX format: 
/etc/fscv —v /dev/rdsk/cntrir_0s0 /dev/rdsk/cnirir_1s0 
Perform an in-place conversion from VAX to M68000 format: 


/etc/fscv —m /dev/rdsk/cntrir_1s0 


BUGS 
The boot block is not modified during conversion; the resulting file system is not bootable. No 
data contained in the files of the file system are modified. 

SEE ALSO 


fsck(1M), volcopy(1M). 
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NAME 

fsdb — file system debugger 
SYNOPSIS 

/etc/fsdb special [| — ] 
DESCRIPTION 


Fsdb can be used to patch up a damaged file system after a crash. It has conversions to 
translate block and i-numbers into their corresponding disk addresses. Also included are 
mnemonic offsets to access different parts of an inode. These greatly simplify the process of 
correcting control block entries or descending the file system tree. 


F’sdb contains several error checking routines to verify inode and block addresses. These can 
be disabled if necessary by invoking fsdb with the optional — argument or by the use of the 
O symbol. (F'sdb reads the i-size and f-size entries from the superblock of the file system as 
the basis for these checks.) 


Numbers are considered decimal by default. Octal numbers must be prefixed with a zero. 
During any assignment operation, numbers are checked for a possible truncation error due to a 
size mismatch between source and destination. 


Fsdb reads a block at a time and, therefore, works with raw as well as block I/O. A buffer 
management routine is used to retain commonly used blocks of data in order to reduce the 
number of read system calls. All assignment operations result in an immediate write-through 
of the corresponding block. 


The symbols recognized by /fsdb are: 
absolute address 

1 convert from i-number to inode address 

b convert to block address 

d directory slot offset 

+,— address arithmetic 

q quit 

a Save, restore an address 

= numerical assignment 
incremental assignment 
decremental] assignment 
character string assignment 
error checking flip flop 
general print facilities 
file print facility 
byte mode 
word mode 
double word mode 
escape to shell 


ee Oa ti 


The print facilities generate a formatted output in various styles. The current address is nor- 
malized to an appropriate boundary before printing begins. It advances with the printing and 
is left at the address of the last item printed. The output can be terminated at any time by 
typing the delete character. If a number follows the p symbol, that many entries are printed. 
A check is made to detect block boundary overflows, since logically sequential blocks are gen- 
erally not physically sequential. If a count of zero is used, all entries to the end of the 
current block are printed. The print options available are: 

print as inodes 

print as directories 

print as octal words 

print as decimal words 


o Oo Ga 
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c print as characters 
b print as octal bytes 


The f symbol is used to print data blocks associated with the current inode. If followed by a 
number, that block of the file is printed. (Blocks are numbered from zero.) The desired print 

option letter follows the block number, if present, or the f symbol. This print facility works 
for small as well as large files. It checks for special devices and that the block pointers used 
to find the data are not zero. 


Dots, tabs and spaces may be used as function delimiters but are not necessary. A line with 
just a newline character increments the current address by the size of the data type last 
printed. That is, the address is set to the next byte, word, double word, directory entry or 
inode, allowing the user to step through a region of a file system. Information is printed in a 
format appropriate to the data type. Bytes, words and double words are displayed with the 
octal address followed by the value in octal and decimal. A .B or .D is appended to the 
address for byte and double word values, respectively. Directories are printed as a directory 
slot offset followed by the decimal i-number and the character representation of the entry — 
name. Inodes are printed with labeled fields describing each element. 


The following mnemonics are used for inode examination and refer to the current working 


inode: 
md mode 
In link count 
uid user ID number 
gid group ID number 
SZ file size 
a# data block numbers (0 — 12) 
at access time 
mt modification time 
maj major device number 
min minor device number 
EXAMPLES 
386i prints i-number 386 in an inode format. This now becomes the current 
working inode. 
In=4 changes the link count for the working inode to 4. 
In=+1- increments the link count by 1. 
fc prints, in ASCII, block zero of the file associated with the working inode. 
2i.fd prints the first 32 directory entries for the root inode of this file system. 
d5i.fc changes the current inode to that associated with the 5th directory entry 
(numbered from zero) found from the above command. The first logical 
block of the file is then printed in ASCII. | 
512B.pO0o0 prints the superblock of this file system in octal. 
2i.aQb.d7=3 changes the i-number for the seventh directory slot in the root directory to 


3. This example also shows how several operations can be combined on one 
command line. 


d7.nm="name" changes the name field in the directory slot to the given string. Quotes are 
optional when used with nm if the first character is alphabetic. 


a2b.p0d prints the third block of the current inode as directory entries. 


SEE ALSO 
fsck(1M), dir(4), fs(4). 
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NA ME 


fuser — identify processes using a file or file structure 


SYNOPSIS 


/etc/fuser [—ku ] files [ — ] [[ —ku ] files ] 


DESCRIPTION 


Fuser lists the process IDs of the processes using the files specified as arguments. For block 
special devices, all processes using any file on that device are listed. The process ID is fol- 
lowed by c, p or r if the process is using the file as its current directory, the parent of its 
current directory (only when in use by the system), or its root directory, respectively. If the 
—u option is specified, the login name, in parentheses, also follows the process ID. In addition, 
if the —k option is specified, the SIGKILL signal is sent to each process. Only the superuser 
can terminate another user’s process (see kill(2)). Options may be respecified between groups 
of files. The new set of options replaces the old set, with a lone dash canceling any options 
currently in force. 


The process IDs are printed as a single line on the standard output, separated by spaces and ter- 
minated with a single new line. All other output is written on standard error. 


EX AMPLES 


fuser —ku /dev/dsk/cntrir_]s? 
terminates all processes that are preventing disk drive one from being unmounted if 
typed by the superuser, listing the process ID and login name of each as it is killed. 
fuser —u /etc/passwd 
lists process IDs and login names of processes that have the password file open. 
fuser —ku /dev/dsk/cntrir_ls? —u /etc/passwd 
does both of the above examples in a single command line. 


FILES 
/unix for namelist 
/dev/kmem for system image 
/dev/mem also for system image 
SEE ALSO 


mount(1M), ps(1), kill(2), signal(2). 
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NAME 


fwtmp, wtmpfix — manipulate connect accounting records 


SYNOPSIS 


/usr/lib/acct/fwtmp [—ic] 
/usr/lib/acct/wtmpfix [files] 


DESCRIPTION 
Fwtmp 


Fwtmp reads from the standard input and writes to the standard output, converting binary 
records of the type found in wtmp to formated ASCII records. The ASCII version is useful to 
enable editing, via ed(1), bad records or general purpose maintenance of the file. 


The argument —ic is used to denote that input is in ASCII form, and output is in binary form. 


Wtmpfix 


Wimp fix examines the standard input or named files in wtmp format, corrects the time/date 
stamps to make the entries consistent, and writes to the standard output. A — can be used in 
place of files to indicate the standard input. If time/date corrections are not performed, acct- 
conl faults when it encounters certain date change records. 


Each time the date is set, a pair of date change records are written to /etc/wtmp. The first 
record is the old date denoted by the string old time placed in the line field and the flag 
OLD_TIME placed in the type field of the <utmp.h> structure. The second record specifies 
the new date and is denoted by the string new time placed in the line field and the flag 
NEW_TIME placed in the type field. Wtmp/fix uses these records to synchronize all time 
stamps in the file. | 


In addition to correcting time/date stamps, wtmp fix checks the validity of the name field to 
ensure that it consists solely of alphanumeric characters, a $, or spaces. If it encounters a name 
that is considered invalid, it changes the login name to INVALID and writes a diagnostic to the 
standard error. In this way, wtmp/fix reduces the chance of acctcon/ failure, when processing 
connect accounting records. 


FILES 
/etc/wtmp 
/usr/include/utmp.h 
SEE ALSO 


acct(1M), acctcms(1M), acctcom(1), acctcon(1M), acctmerg(1M), acctprc(1M), acctsh(1M), 
runacct(1M), acct(2), acct(4), utmp(4). 
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NAME 
getty — set terminal type, modes, speed, and line discipline 

SYNOPSIS 
/etc/getty [| —h ] [ —t timeout ] line [ speed [ type [ linedisc ] ] ] 
/etc/getty —c file 

DESCRIPTION 


Getty is a program that is invoked by init(1M). It is the second process in the series (init- 
getty-login-shell) that ultimately connects a user with SYSTEM V/68. Initially getty prints 
the login message field for the entry it is using from /etc/gettydefs. Getty reads the user’s 
login name and invokes the login(1) command with the user’s name as argument. While 
reading the name, getty attempts to adapt the system to the speed and type of terminal being 
used. 


Line is the name of a tty line in /dev to which getty is to attach itself. Getty uses this string 
as the name of a file in the /dev directory to open for reading and writing. Unless getty is 
invoked with the —h flag, getty forces a hangup on the line by setting the speed to zero 
before setting the speed to the default or specified speed. The —t flag plus timeout in seconds, 
specifies that getty should exit if the open on the line succeeds and no one types anything in 
the specified number of seconds. The optional second argument, speed, is a label to a speed 
and tty definition in the file /etc/gettydefs. This definition tells getty what speed to ini- 
tially run at, what the login message should look like, what the initial tty settings are, and 
What speed to try next should the user indicate that the speed is inappropriate (by typing a 
<break > character.) The default speed is 9600 baud. The optional third argument, type, is a 
character string describing to getty what type of terminal is connected to the line in question. 
Getty understands the following types: | 


none default 

vt6l DEC vt6] 

vt100 DEC vt100 

hp45 Hewlett-Packard HP45 
c100 Concept 100 


The default terminal is none, i.e., any crt or normal terminal unknown to the system. Also, 
for terminal type to have any meaning, the virtual terminal handlers must be compiled into 
the operating system. They are available, but not compiled, in the default condition. The 
optional fourth argument, linedisc, is a character string describing which line discipline to use 
in communicating with the terminal. Again the hooks for line disciplines are available in the 
operating system, but there is only one’ presently available, the default line discipline, LDISCO. 


When given no optional arguments, getty sets the speed of the interface to 9600 baud, speci- 
fies that raw mode is used (awaken on every character), echo is suppressed, either parity is 
allowed, newline characters are converted to carriage return-line feed, and tab expansion 1s 
performed on the standard output. It types the login message, then reads the user’s name, a 
character at a time. If a null character (or framing error) is received, it is assumed to be the 
result of the user pressing the “break” key. This causes getty to attempt the next speed in the 
series. The series that getty tries is determined by what it finds in /etc/gettydefs. 


The user’s name is terminated by a newline or carriage-return character. The latter results in 
the system being set to treat carriage returns appropriately (see termio(7)). 


The user’s name is scanned to see if it contains any lowercase alphabetic characters; if not, and 
if the name is not empty, the system is told to map any future uppercase characters into the 
corresponding lowercase characters. 

Finally, login is called with the user’s name as an argument. Additional arguments may be 
typed after the login name. These are passed to login, which places them in the environment 
(see login )). ( 
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FILES 


A check option is provided. When getty is invoked with the —c option and file, it scans the 
file as if it were scanning /etc/gettydefs and prints the results to the standard output. If 
there are any unrecognized modes or improperly constructed entries, it reports these. If the 
entries are correct, it prints out the values of the various flags. See termio(7) to interpret the 
values. Note that some values are added to the flags automatically. 


/etc/gettydefs 


SEE ALSO | 


BUGS 


ct(1C), init(1MD), login(1), termio(7), gettydefs(4), inittab(4), tty(7), "Setting up SYSTEM V/68" 
in the SYSTEM \V/68 Administrator's Guide. 3 


While getty does understand simple single-character quoting conventions, it is not possible to 
quote the special control characters that gefty uses to determine when the end of the line has 
been reached, which protocol] is being used, and what the erase character is. Therefore, it is 
not possible to log in via getty and type a #, @, /,!, _, backspace, “U, “D, or & as part of the 
login name or arguments. They will always be interpreted as having their special meanings as 
described above. 
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NAME 


init, telinit —- process control initialization 


SYNOPSIS 


/etc/init [0123456SsQq ] 
/bin/telinit [0123456sSQqabc ] 


DESCRIPTION 


Init 


The primary role of init is to create processes from a script stored in the file /etc/inittab (see 
inittab(4)). This file usually has init generate getty’s on each line that a user may log in on. It 
also controls autonomous processes required by any particular system. 


Init considers the system to be in a run-level at any given time. A run-level can be viewed as 
a software configuration of the system where each configuration allows only a selected group 
of processes to exist. The processes generated by init for each of these run-levels is defined 
in the inittab file. Init can be in one of eight run-levels, 0-6, and S or s. The run-level is 
changed by having a privileged user run /etc/init (which is linked to /bin/telinit and 
/etc/init8). This user-generated init sends appropriate signals to the orginal init created by 
the operating system when the system was rebooted, telling it which run-level to change to. 


Init is invoked inside the SYSTEM V/68 operating system as the last step in the boot pro- 
cedure. The first thing init does is to look for /etc/inittab and see if there is an entry of the 
type initdefault (see inittab(4)). If there is, init uses the run-level specified in that entry as the 
initial run-level to enter. If this entry is not in inittab or inittab is not found, init requests that 
the user enter a run-level from the virtual system console, /dev/syscon. If an S (s) is entered, 
init goes into the SINGLE USER level. This is the only run-level that doesn’t require the 
existence of a properly formatted inittab file. If /etc/inittab doesn’t exist, then by default the 
only legal run-level that init can enter is the SINGLE USER level. In the SINGLE USER 
level, the virtual console terminal /dev/syscon is opened for reading and writing, and the 
command /bin/su is invoked immediately. To exit from the SINGLE USER run-level, one of 
two options can be selected. First, if the shell is terminated (via an end-of-file), init reprompts 
for a new run-level. Second, the init or telinit command can signal init and force it to change 
the run-level of the system. | | 


When attempting to boot the system, failure of init to prompt for a new run-level may be due 
to the fact that the device /dev/syscon is linked to a device other than the physical system 
teletype (/dev/systty). If this occurs, init can be forced to relink /dev/syscon by typing a 
delete on the system teletype which is located with the processor. 


When init prompts for the new run-level, the operator may only enter one of the digits 0 
through 6 or the letters S or s. If S is entered, init operates as previously described in SIN- 
GLE USER mode with the additional result that /dev/syscon is linked to the user’s terminal 
line, thus making it the virtual system console. A message is generated on the physical con- 
sole, /dev/systty, saying where the virtual terminal has been relocated. 


When init comes up initially and whenever it switches out of SINGLE USER state to normal 
run states, it sets the foctl(2) states of the virtual console, /dev/syscon, to those modes saved 
in the file /etc/ioctl.syscon. This file is written by init whenever SINGLE USER mode is 
entered. If this file doesn’t exist when init wants to read it, a warning is printed and default 
settings are assumed. 


If a 0 through 6 is entered, init enters the corresponding run-level. Any other input is 


rejected and the user is reprompted. If this is the first time init has entered a run-level other 


than SINGLE USER, init first scans inittab for special entries of the type boot and bootwait. 
These entries are performed, providing the run-level entered matches that of the entry before 
any normal processing of inittab takes place. In this way, any special initialization of the 


ee 
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operating system (such as mounting file systems) can take place before users are allowed onto 
the system. The inittab file is scanned to find all entries that are to be processed for that 
run-level. | 


Run-level 2 is usually defined by the user to contain all of the terminal processes and dae- 
mons that are generated in the multi-user environment. 


In a multi-user environment, the inittab file is usually set up so that init creates a process for 
each terminal on the system. 


For terminal processes, ultimately the shell terminates because of an end-of-file either typed 
explicitly or generated as the result of hanging up. When init receives a signal telling it that a 
process it created has died, it records the fact and the reason it died in /etc/utmp and 
/etc/wtmp if it exists (see who(1)). A history of the processes generated is kept in /etc/wtmp 
if such a file exists. 


To create each process in the inittab file, init reads each entry and for each entry that should 
be regenerated, it creates a process. After it has generated all of the processes specified by 
the inittab file, init waits for one of its descendant processes to die, a powerfail signal, or until 
init is signaled by init or telinit to change the system’s run-level. When one of the above three 
conditions occurs, init re-examines the inittab file. New entries can be added to the inittab 
file at any time; however, init still waits for one of the above three conditions to occur. To 
provide for an instantaneous response the init Q or init q command can wake init to re- 
examine the inittab file. 


If init receives a powerfail signal (SIGPWR) and is not in SINGLE USER mode, it scans init- 
tab for special powerfail entries. These entries are invoked (if the run-levels permit) before 
any further processing takes place. In this way, init can perform various cleanup and record- 
ing functions whenever the operating system experiences a power failure. It is important to 
note that the powerfail entries should not use devices that must first be initialized after a 
power failure has occurred. | 


When init is requested to change run-levels (via ¢elinit), init sends the warning signal 
(SIGTERM) to all processes that are undefined in the target run-level. Init waits 20 seconds 
before forcibly terminating these processes via the kill signal (SIGKILL). 

Telinit 
Telinit, which 1s linked to /etc/init, is used to direct the actions of init. It takes a one charac- 
ter argument and signals init via the kill system call to perform the appropriate action. The 
following arguments serve as directives to init. 


0—6 place the system in one of the run-levels 0-6. 

a,b,c process only those /etc/inittab file entries having the a, b or c run-level set. | 
Q,q re-examine the /etc/inittab file. 

s,S enter the single-user environment. When this level change is effected, the 


virtual system teletype, /dev/syscon, is changed to the terminal from which 
the command was executed. 


Telinit can only be run by someone who is superuser or a member of group sys. 


FILES 
/etc/inittab 
/etc/utmp 
/etc/wtmp 
/etc/ioctl.syscon 
/dev/syscon 
/dev/systty 
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SEE ALSO 
getty(1M), login(1), sh(1), who(1), kill(2), inittab(4), utmp(4). 
“Setting up SYSTEM V/68” in the SYSTEM V/68 Administrator’s Guide . 

DIAGNOSTICS 
If init finds that it is continuously regenerating an entry from /etc/inittab more than 10 times 
in 2 minutes, it assumes that there is an error in the command string, and generates an error 
message on the system console. It does not regenerate this entry until either 5 minutes has 
elapsed or it receives a signal from a user init (telinit). This prevents init from eating up sys- 


tem resources when someone makes a typographical error in the inittab file or a program is 
removed that is referenced in the inittab. 


BUGS 
When changes to the init state of the system are made, a condition could develop where one 
process opened the console for I/O while another process closed it. The process that had 
opened the console would be unable to proceed and the sytem would hang, necessitating a 
reboot. This problem would be encountered only when using single-user mode for other than 
normal startup and then switching to multi-user mode. 
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NAME 
install — install commands 

SYNOPSIS | 
/etc/install [—c dira] [—f dirb] [—i] [—n dirc] [—o] [—s] file [dirx ...] 

DESCRIPTION 7 | 
Install is a command most commonly used in “makefiles” (see make(1)) to install a file 
(updated target file) in a specific place within a file system. Each /ile is installed by copying 
it into the appropriate directory, thereby retaining the mode and owner of the original com- 
mand. The program prints messages telling the user exactly what files it is replacing or creat- 
ing and where they are going. — 
If no options or directories (dirx ...) are given, install searches a set of default directories 
(/bin, /usr/bin, /etc, /lib, and /usr/lib, in that order) for a file with the same name as file. 
When the first occurrence is found, install issues a message saying that it is overwriting that 
file with file, and proceeds to do so. If the file is not found, the program states this and exits 
without further action. 
If directories (dirx ...) are specified after file, they are searched before the directories speci- 
fied in the default list. 
The meanings of the options are: : 

—c dira Installs a new command (file) in the directory specified by dira, only 
if it is not found. If it is found, install issues a message saying that the 
file already exists, and exits without overwriting it. May be used alone 
Or with the —s option. 

—f dirb Forces file to be installed in a given directory, whether or not one | 
already exists. If the file being installed does not already exist, the 
mode and owner of the new file is set to 755 and bin, respectively. If 
the file already exists, the mode and owner is that of the already exist- 
ing file. May be used alone or with the —o or —s options. 

—1 Ignores default directory list, searching only through the given direc-. 
tories (dirx ...). May be used alone or with options other than —c and 
—f. 

—n dirc If file is not found in any of the searched directories, it is put in the 
directory specified in dirc. The mode and owner of the new file is set 
to 755 and bin, respectively. May be used alone or with options other 
than —c and —f. 

—o If file is found, this option saves the “found” file by copying it to OLD- 
jfile in the directory in which it was found. This option is useful when 
installing a normally text busy file such as /bin/sh or /etc/getty, 
where the existing file cannot be removed. May be used alone or with 
options other than —c. 

—s | Suppresses printing of messages other than error messages. May be used 
alone or with any other options. 

SEE ALSO 


-make(1), mk(8). 
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NAME 

Killall — kill all active processes 
SYNOPSIS 

/etc/killall [ signal ] 
DESCRIPTION 


Killall is a procedure used by /etc/shutdown to kill all active processes not directly related 
to the shutdown procedure. 


Killall is chiefly used to terminate all processes with open files so that the mounted file sys- 
tems can be unmounted. 


Killall sends signal (see kill(1)) to all remaining processes not belonging to the above group of 
exclusions. If no signal is specified, a default of 9 is used. 


FILES 
/etc/shutdown 


SEE ALSO | 
fuser(1M), kill(1), ps(1), shutdown(1M), signal(2). 


LINK(1M) | LINK (1M) 


NAME 
link, unlink — exercise link and unlink system calls 


SYNOPSIS 
/etc/link file1 file2 
/etc/unlink file 


DESCRIPTION | 
Link and unlink perform system calls on their arguments, abandoning all error checking. 
These commands may only be executed by the superuser. 


SEE ALSO 
rm(1), link(2), unlink(2). 
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LPADMIN( 1M) 


lpadmin — configure the LP spooling system 


SYNOPSIS 


/usr/lib/lpadmin —p printer [ options ] 
/usr/lib/lpadmin —-x dest 
/usr/lib/lpadmin —d{dest] 


DESCRIPTION 


Lpadmin configures LP spooling systems to describe printers, classes and devices. It is used to 
add and remove destinations, change membership in classes, change devices for printers, 
change printer interface programs, and change the system default destination. Lpadmin may 
not be used when the LP scheduler, lpsched (1M), is running, except where noted below. 


One of the —p, —d or —x options must be present for every legal invocation of lpadmin . 


—d{dest] 


—xdest 


—pprinter 


makes dest , an existing destination, the new system default destination. If dest 
is not supplied, then there is no system default destination. This option may be 
used when lpsched(1M) is running. No other options are allowed with —d. 


removes destination dest from the LP system. If dest is a printer and is the 
only member of a class, then the class is deleted, too. No other options are 
allowed with —x. 


names a printer to which all of the options below refer. If printer does not 
exist then it is created. 


The following options are only useful with —p and may appear in any order. For ease of dis- 
cussion, the printer will be referred to as P below. 


—cclass 
—eprinter 
—h 

—linter face 


—l 


—mymodel 
—rclass 


—vdevice 


Restrictions. 


inserts printer P into the specified class. Class is created if it does not already 
exist. 


copies an existing printer’s interface program to be the new interface program 
for P. 


indicates that the device associated with P is hardwired. This option is assumed 
when creating a new printer, unless the —1 option is supplied. 


establishes a new interface program for P. Inter face is the pathname of the 
new program. 


indicates that the device associated with P is a login terminal. The LP 
scheduler, lpsched, disables all login terminals automatically each time it is 
started. Before re-enabling P, its current device should be established using 
Lpadmin . 


selects a model interface program for P. Model is one of the model interface 
names supplied with the LP software (see Models below). 


removes printer P from the specified class. If P is the last member of the 
class, then the class is removed. 


associates a new device with printer P. Device is the pathname of a file that is 
writable by the LP administrator, Jp. Note that there is nothing to stop an 
administrator from associating the same device with more than one printer. If 
only the —p and —v options are supplied, then lpadmin may be used while the 
scheduler is running. 


When creating a new printer, the —v option and only one of the —e, —i or —m options must 
be supplied. The —h and —1 keyletters are mutually exclusive. Printer and class names may 
be no longer than 14 characters and must consist entirely of the characters A-Z, a-z, 0-9 and 
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_ (underscore). 


Models. 


Model printer interface programs are supplied with the LP software. They are shell pro- 
cedures which interface between lpsched and devices. All models reside in the directory 
/usr/spool/lp/model and may be used as is with lpadmin —m. Alternatively, LP adminis- 
trators may modify copies of models and then use /padmin —1i to associate them with printers. 


The 


following list describes the models and lists the options which they may be given on the 


lp command line using the —o keyletter: 


dumb _ interface for a line printer without special functions and protocol. Form feeds are 


assumed. This is a good model to copy and modify for printers which do not have 
models. 


1640 ~— Diablo 1640 terminal running at 1200 baud, using XON/XOFF protocol. Options: 


—12 12-pitch (10-pitch is the default) 
—f don’t use the 450(1) filter. The output has been pre-processed by either 
450(1) or the nroff 450 driving table. 


hp Hewlett Packard 2631A line printer at 2400 baud. Options: 
—C compressed print 
—e expanded print 
prx Printronix P300 or P600 printer using XON/XOFF protocol at 1200 baud. 
EX AMPLES - 
1. Assuming there is an existing Hewlett Packard 2631A line printer named hp2, it uses the 
hp model interface after the command: | 
/usr/lib/lpadmin —php2 —mhp 
2. To obtain compressed print on hp2, use the command: 
lp —dhp2 —o—c files 
3. A Diablo 1640 printer called st] can be added to the LP configuration with the command: 
/usr/lib/Ipadmin —pst1 —v/dev/tty20 —m1640 
4. Annrof f document may be printed on sti in any of the following ways: 
nroff —T450 files | lp —dstl —of 
nroff —T450—12 files | lp —dst1 —of 
nroff —T37 files | col | lp —dst1 
5. The following command prints the password file on st1 in 12-pitch: 
Ip —dst1 —o12 /etc/passwd 
NOTE: the —12 option to the 1640 model should never be used in conjunction with 
nrof f. 
FILES 
/usr/spool/1p/+* 
SEE ALSO 


450(1), accept(1M), enable(1), 1p(1), Ipsched(1M), Ipstat(1), “LP Spooling System” in SYSTEM 
V/68 Administrator's Guide. 
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lpsched, lpshut, lpmove — start/stop the LP request scheduler and move requests 


SYNOPSIS 


/usr/lib/lpsched 
/usr/lib/lpshut 
/usr/lib/lpmove requests dest 
/usr/lib/lpmove dest1  dest2 


DESCRIPTION 


FILES 


Lpsched schedules requests taken by /p(1) for printing on line printers. 


Lpshut shuts down the line printer scheduler. All printers that are printing at the time 
Lpshut is invoked stop printing. Requests that were printing at the time a printer was shut 
down are reprinted in their entirety after l[psched is started again. All LP commands perform 
their functions even when /psched is not running. 


Lpmove moves requests that were queued by lp(1) between LP destinations. This command 
may be used only when lpsched is not running. 


The first form of the command moves the named requests to the LP destination, dest. 
Requests are request ids as returned by lp. The second form moves all requests for destina- 
tion dest 1 to destination dest2. Asa side effect, lp rejects requests for dest 1. 


Note that Lpmove never checks the acceptance status (see accept (1M)) for the new destination 
when moving requests. : 


/usr/spool/1p/* 


SEE ALSO 


accept(1M), enable(1), 1p(1), lpadmin(1M), Ipstat(1), “LP Spooling System” in SYSTEM V/68 
Administrator's Guide. 


M320FMT (1M) | -_M320FMT (1M) 


NAME | 

m320fmt — format disks on the MYVME320 disk controller 
SYNOPSIS 

m320fmt [hard disk enable —h heads —c cylinders] rawdev 
DESCRIPTION 


The m320fmt utility is used to format disks on the MYME320 controller. Winchester 
(“hard”) disks are formatted in a continuous operation which will keep the controller busy 
until it completes. Floppy disks are formatted track-by-track, permitting other I/O operations 
to intervene. Support for bad track handling on the MVME320 controller is done in software 
only. Therefore the m320fmt utility should be used only for diskettes or for media that has 
no defects listed on the Winchester verification report. To format any media that contains 
imperfections or that is to be booted, use the dinit(1M) utility. Refer to dinit(1M). To per- 
form the calculations needed to enter the media imperfections with the dinit utility, use the 
conversion procedures described below. 


The following options are available: 


The string hard_disk_ enable must appear as shown to enable formatting of a hard 
disk. It may not appear if the target disk is a floppy. 


—h | The number of heads (surfaces per cylinder) on the target hard disk. 
—c The number of cylinders:on the target hard disk. 


rawdev must be a raw device defined on the target unit (/dev/rdsk/m320_...). The slice 
number is irrelevant for hard disks, but must be one which spans the entire 
volume for floppy disks. By convention, slice 7 is thus defined. M320fmt gen- 
erates a warning message if it finds a floppy slice other than 7. 


The dinit(1M) utility invokes m320fmt(1M), a disk formatter for MVME320 devices. Dinit 
enters an interactive mode and prompts the user for bad track entries. Check the Winchester 

- verification report supplied by the disk manufacturer for a list of bad blocks or imperfections 
on the disk. If no bad blocks are listed, type a period ( . ) to terminate the bad track han- 
dling phase of disk initialization. The device is assumed to be perfect. 


_If imperfections are listed on the verification report, you must perform some calculations to 
convert the information on the report into a form recognized by the utility. The dinit utility 
expects a list of bad tracks. The Winchester verification report lists media imperfections in 
one of two ways: either the report gives the sector number of the first bad sector on a track, 
or the report identifies the problem area by head number, cylinder number, and byte offset. 
To calculate the bad tracks from the information provided on the verification report, use one 
of the following methods, whichever is appropriate to your disk: 


METHOD 1: Calculate Bad Tracks from Sector Numbers 


To obtain the bad track numbers, divide each sector number listed in the Winchester 
verification report by the number of sectors per track. Since all supported drives (Computer 
Memories, Micropolis, and Vertex) contain 32 sectors per track, the conversion equation 
becomes: 


track number = (sector number) / 32 
METHOD 2: Calculate Bad Tracks from Head and Cylinder Numbers 


(cylinder number) x (total # of heads) + (head number) = track number 
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The 15Mb Computer Memories drive and the 40Mb Micropolis drive have 6 heads. The 
Vertex 40Mb drive has 5 heads. 


After m320fmt has formatted the device, dinit sets up the volume-id and the configuration 
sectors, records the bad track information, and installs the boot loader on the drive. 


(NOTE: If a Winchester disk is formatted without making the required bad track entries, 
proper operation cannot be guaranteed.) 


BUGS 
An error in specifying heads or cylinders for a hard disk may result in a disk which appears 
to be correctly formatted but generates physical I/O errors in high cylinders (bad precomp 
values) or seems to have “lost” some of its space (surface mapped out). Dinit(1M) references 
a Motorola-prepared file which contains accurate values for these parameters. 


SEE ALSO 
dinit(1M), m320(7). 
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NAME 

m350ctl - MVME350 control program 
SYNOPSIS 

m350ctl [ —retwg ] [ —fx ] [ -s[n[kbl]] [ special ] 
DESCRIPTION 


M350ctl controls function of the MVME350 streaming tape device. The following options are 
interpreted by m350ctl: 


—r Rewind tape. 

—e Erase tape. 

—t Retension tape. 

—w Open tape for writing (with filemark). 
—fx Position tape at the front of file x. 

—g Print DMA buffer size. 


—sn Set DMA buffer size. The buffer size is set to n bytes, nb (or nB) blocks, or nk (or 
nK) Kbytes. If n is not specified, the buffer size set to default value of 128 Kbytes. 
If n is zero, then double buffering is turned off. 


If the special file is not given, standard input will be used. For example, the command 
# m350ctl -e /dev/rmt/m350_0a 
is identical to 
# m350ctl -e < /dev/rmt/m350_0a 
If the —w option is used, the default special file is standard output. Thus, the command 
# m350ctl -ew /dev/rmt/m350_ Ot 
is identical to 
# m350ctl -ew > /dev/rmt/m350_ Ot 


See mvme350(7) for more information regarding special file naming conventions. 
FILES 

/dev/rmt/m350_* 
SEE ALSO 

mvme350(7). — 
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mkfs — construct a file system 


SYNOPSIS 


/etc/mkfs special blocksl:inodes] [gap blocks/cy1] 
/etc/mkfs special proto [gap blocks/cy1] 


DESCRIPTION 


Mkfs constructs a file system by writing on the special file according to the directions found 
in the remainder of the command line. The command waits 10 seconds before starting to con- 
struct the file system. If the second argument is given as a string of digits, mk fs builds a file 
system with a single empty directory on it. The size of the file system is the value of blocks 
interpreted as a decimal number. This is the number of physical disk blocks the file system 
occupies. The boot program is left uninitialized. If the optional number of inodes is not given, 
the default is the number of logical blocks divided by 4. 


If the second argument is a filename that can be opened, mk f's assumes it to be a prototype file 
proto, and takes its directions from that file. The prototype file contains tokens separated by 
spaces or newlines. The first token is the name of a file to be copied onto block zero as the 
bootstrap program (see ops.macs(8)). The second token is a number specifying the size of the 
created file system in physical disk blocks. Typically, it is the number of blocks on the dev- 
ice, perhaps diminished by space for swapping. The next token is the number of inodes in the 
file system. The maximum number of inodes configurable is 65500. The next set of tokens 
comprise the specification for the root file. File specifications consist of tokens giving the mode, 
the user ID, the group ID, and the initial contents of the file. The syntax of the contents net 
depends on the mode. 


The mode token for a file is a 6-character string. The first character specifies the type of the 
file. (The characters —bed specify regular, block special, character special and directory files 
respectively.) The second character of the type is either u or — to specify set-user-id mode or 
not. The third is g or — for the set-group-id mode. The rest of the mode is a three-digit octal 
number giving the owner, group, and other read, write, execute permissions (see chmod (1)). 


Two decimal number tokens come after the mode; they specify the user and group ID’s of the 
owner of the file. 


If the file is a regular file, the next token is a pathname from which the contents and size are 
copied. If the file is a block or character special file, two decimal number tokens follow, 
Which give the major and minor device numbers. If the file is a directory, mk fs makes the 
entries . and .. and then reads a list of names and (recursively) file specifications for the 
entries in the directory. The scan is terminated with the token §. 


A sample prototype specification follows: 


/stand/diskboot 

4872 110 

d——777 31 

usr d——777 31 
sh ———755 3 1 /bin/sh 
ken d——755 61 


$ 
b0 b——644 3100 
cO c——644 3100 
$ 
$ 


In both command syntaxes, the rotational gap and the number of blocks per cycle can be 
specified. Default values are 7 for gap size and 400 blocks per cycle. The default will be used 
if the supplied gap and blocks/cycle are considered illegal values or if a short argument count 


MK FS (1M) , MK FS (1M) 


OCCUTS. 


SEE ALSO 
chmod(1), dir(4), fs(4), bo.macs(8), bo.vme(8), ops.macs(8). 
“Setting up SYSTEM V/68” in the SYSTEM V/68 Administrator's Guide . 


BUGS 
If a prototype is used, it is not possible to initialize a file larger than 64Kb, nor is there a way 
to specify links. 
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NAME 
mknod — build special file 


SYNOPSIS 
/etc/mknod name c |b major minor 
/etc/mknod name p 


DESCRIPTION 
Mknod makes a directory entry and corresponding inode for a special file. The first argu- 
ment is the name of the entry. In the first case, the second is b if the special file is block- 
type (disks, tape) or c if it is character-type (other devices). The last two arguments are 
numbers specifying the major device type and the minor device, e.g., unit, drive, or line 
number, which may be either decimal or octal. | 


The assignment of major device numbers is specific to each system and found in the system 
source file: conf.c. 


Mknod can also be used to create fifo’s (pipes). (See the second case in the above SY NOPSIS.) 


SEE ALSO . 
mknod(2). 
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* 


TAME 
mnt, umnt — mount and dismount file system 


YNOPSIS 
/mot/bin/mnt [. name [ directory ] ] [-r] 
/mot/bin/umnt [ name ] | 
JESCRIPTION 
Mnt (umnt) has an optional argument, name. This argument is used to search the permissions 
file to determine the real device to mount (unmount). The file is searched and when name 


matches either the real_device or the alias entry on a line, the real _device entry is then used 
as the special device to be mounted (unmounted). 


The default value for alias is default. The default value for directory is whatever directory is 
listed in the mntpt entry of the permissions file. 


Mnt announces to the system that a removable file system is present on the special device. 
The directory must exist already; it becomes the name of the root of the newly mounted file 
system. 


The optional last argument indicates that the file is to be mounted read-only. Write-protected 
and magnetic tape file systems must be mounted in this way or errors will occur when access 
times are updated, whether or not any explicit write is attempted. If the user has not been 
granted Write permission for the alias (as controlled by the perms entry of the permissions 
file), the device will be mounted read-only. 


Umnt announces to the system that the removable file system previously mounted on a special 
device is to be removed. , | : 


By convention mount(1M) and umount(1M) require root permission to execute. Normal users 

must use mnt when dealing with mountable media. 
ILES 

/etc/mnttab mount table 

/etc/mount 

/etc/umount 

/mot/bin/mnt 

/mot/bin/umnt 

/mot/etc/perms permissions file 
EE ALSO 

mount(1M), mnttab(4), perms(4). 


IAGNOSTICS | 
-Mnt issues a warning if the file system to be mounted is currently mounted under another 
name. 
Umnt complains if the special file is not mounted or if it is busy. The file system is busy if it 
contains an open file or a user’s working directory. 

UGS 

The permissions file is not checked for read permission, before mounting a disk. 


Some degree of validation is done on the file system; however, it is generally unwise to mount 
garbage file systems. 
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NAME 


MOUNT(1IM) 3 ae '  MOUNT(1M) 


= 


mount, umount — mount and dismount file system 


SYNOPSIS 
/etc/mount [ special directory [ —r ] ] 


/etc/umount special 
DESCRIPTION 
Mount announces to the system that a removable file system is present on the device special. 


The directory must exist already; it becomes the name of the root of the newly mounted file 
system. 


These commands maintain a table of mounted devices. If invoked with no arguments, mount _ 
prints the table. 


The optional last argument indicates that the file is to be mounted read-only. Write-protected 
and magnetic tape file systems must be mounted in this way or errors will occur when access 
times are updated, whether or not any explicit write is attempted. 


Umount announces to the system that the removable file ayer previously mounted on dev- 
ice special is to be removed. 


FILES 
/etc/mnttab mount table 
SEE ALSO 
setmnt(1M), mount(2), mnttab(4). 
DIAGNOSTICS 
Mount issues a warning if the file system to be mounted is currently mounted under another 
name. 


Umount complains if the special file is not mounted or if it is busy. The file system is busy if 
it contains an open file or a user’s working directory. 

BUGS | 
Some degree of validation is done on the file system; however, it is generally unwise to 
mount garbage file systems. 
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NAME 

rvdir — move a directory 
SYNOPSIS 

/etc/mvdir dirname name 
DESCRIPTION 


Mvdir renames directories within a file system. Dirname must be a directory; name must 
not exist. Neither name may be a sub-set of the other (/x/y cannot be moved to /x/y/z, nor 
vice versa). 


Only superuser can use mvdir. 


SEE ALSO 
mkdir(1). 
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NAME 

ncheck — generate names from 1-numbers 
SYNOPSIS 

/etc/ncheck [ —i numbers lf a ] [ —s ] [ file-system ] 
DESCRIPTION 


Ncheck generates a list of pathnames and i-numbers of all files on a set of default file systems. 
Names of directory files are followed by /.. The —i option reduces the report to only those 
files whose i-numbers follow. The —a option allows printing of the names . and .., which are 
ordinarily suppressed. The —s option reduces the report to special files and files with set- 
user-ID mode; it is intended to discover concealed violations of security policy. 


A file system may be specified. 


The report is in no useful order. The user can pipe ncheck to the sort(1) utility to ebGin the 
report in a specified order. For example, 


ncheck file system | sort —n —onchecklist 
will produce a list which sorts the i-node numbers numerically; or 
ncheck file_ system | sort +1 —f —onchecklist 
will produce a list which sorts files (in the second column of output) alphabetically by name. 


SEE ALSO 
fsck(1M), sort(1). 


DIAGNOSTICS 
When the file system structure is improper, ?? denotes the “parent” of a parentless file, and a 
pathname beginning with ... denotes a loop. 


oh 
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NAME 


prfld, prfstat, prfdc, prfsnap, prfpr — operating system profiler 


SYNOPSIS 


/etc/prfld [ namelist ] 

/etc/prfstat [ on | 

/etc/prfstat [ off ] 

/etc/prfdc file | period [ off_hour ] |] 
/etc/prfsnap file 

/etc/prfpr file [ cutoff [ namelist ] ] 


DESCRIPTION 


Prfld, prfstat, prfdc, prfsnap, and prfpr form a group of programs to facilitate an 
activity study of the operating system. 


Prfld initializes the recording mechanism in the system. It generates a table containing the 
starting address of each system subroutine as extracted from namelist. 


Pr f stat enables or disables the sampling mechanism. Profiler overhead is less than 1% as cal- 
culated for 500 text addresses. Pr fstat also reveals the number of text addresses being meas- 
ured. 


Prfdc and prfsnap perform the data collection function of the profiler by copying the 
current value of all the text address counters to a file where the data can be analyzed. 
Prfdc stores the counters in file every period minutes and turns off at of f_hour (valid 
values for of f_hour are O—24). Prfsnap collects data at the time of invocation only, 
appending the counter values to /ile. 


Prf pr formats the data collected by prfdc or prfsnap. Each text address is converted to the 
nearest text symbol (as found in namelist ) and is printed if the percent activity for that range 
is greater than cutoff. 


FILES 
/dev/prf interface <o profile data and text addresses 
/unix default fo- namelist file 

SEE ALSO 
prf(7). 
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NAME | | 
pwck, grpck — password/group file checkers 


SYNOPSIS 
/etc/pwek [file] 
/etc/grpck [file] 

_ DESCRIPTION | 
Pwck scans the password file and notes any inconsistencies. The checks include validation of 
the number of fields, login name, user ID, group ID, and whether the login directory and 
optional program name exist. The criteria for determining a valid login name are derived 
from “Setting up SYSTEM V/68” in the SYSTEM V/68 Administrator’s Guide. The default 
password file is /etc/passwd. 
Grpck verifies all entries in the group file. This verification includes a check of the number 
of fields, group name, group ID, and whether all login names appear in the password file. The 
default group file is /etc/group. 

FILES 


/etc/group 
/etc/passwd 


SEE ALSO 
group(4), passwd(4). 
“Setting up SYSTEM V/68” in the SYSTEM V/68 Administrator's Guide. 


DIAGNOSTICS 
Group entries in /etc/group with no login names are flagged. 
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NA ME 

runacct — run daily accounting 
SYNOPSIS 

/usr/lib/acct/runacct [mmdd [state ]] 
DESCRIPTION 


Runacct is the main daily accounting shell procedure. It is normally initiated via cron (1M). 
Runacct processes connect, fee, disk, and process accounting files. It also prepares summary 
files for prdaily or billing purposes. 


Runacct takes care not to damage active accounting files or summary files in the event of 
errors. It records its progress by writing descriptive diagnostic messages into active. When 
an error is detected, a message is written to /dev/console, mail (see mail(1)) is sent to 
root and adm, and runacct terminates. Runacct uses a series of lock files to protect against 
re-invocation. The files lock and lock1 are used to prevent simultaneous invocation, and 
lastdate is used to prevent more than one invocation per day. 


Runacct breaks its processing into separate, restartable states using statefile to remember the 
last state completed. It accomplishes this by writing the state name into statefile. Runacct 
then looks in statefile to see what it has done and to determine what to process next. States 
are executed in the following order: 


SET UP Move active accounting files into working files. 

WT MPFIX Verify integrity of wtmp file, correcting date changes if necessary. 
CONNECT1 Produce connect session records in ctmp.h format. 

CONNECT2 Convert ctmp.h records into tacct.h format. 


PROCESS Convert process accounting records into tacct.h format. 

MERGE Merge the connect and process accounting records. 

FEES Convert output of chargefee into tacct.h format and merge with 
connect and process accounting records. 

DISK Merge disk accounting records with connect, process, and fee account- 
ing records. 

MERGET ACCT 


Merge the daily total accounting records in daytacct with the sum- 
mary total accounting records in /usr/adm/acct/sum/tacct. 


CMS Produce command summaries. 
USEREXIT Include any installation-dependent accounting programs here. 
CLEANUP Cleanup temporary files and exit. 


To restart runacct after a failure, first check the active file for diagnostics, then fix any cor- 
rupted data files such as pacct or wtmp. The lock files and lastdate file must be removed 
before runacct can be restarted. The argument mmdd is necessary if runacct is being res- 
tarted, and specifies the month and day for which runacct reruns the accounting. Entry 
point for processing is based on the contents of statefile; to override this, include the desired 
state on the command line to designate where processing should begin. 


EX AMPLES 
To start runacct: 
nohup runacct 2> /usr/adm/acct/nite/fd2log & 


To restart runacct: 
nohup runacct 0601 2> > /usr/adm/acct/nite/fd2log & 
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To restart runacct at a specific state: 
nohup runacct 0601 MERGE 2> > /usr/adm/acct/nite/fd2log & 


FILES 
/etc/wtmp 
/usr/adm/pacct* 
/usr/src/cmd/acct/tacct.h 
/usr/src/cmd/acct/ctmp.h 
/usr/adm/acct/nite/active 
/usr/adm/acct/nite/daytacct 
/usr/adm/acct/nite/lock 
/usr/adm/acct/nite/lock 1 
/usr/adm/acct/nite/lastdate 
/usr/adm/acct/nite/statefile 
/usr/adm/acct/nite/ptaccts.mmdd 


SEE ALSO | 
acct(1M), acctcms(1M), acctcom(1), acctcon(1M), acctmerg(1M), acctprc(1M), acctsh(1M), 
cron(1M), fwtmp(1M), acct(2), acct(4), utmp(4). 
“Accounting” in the SYSTEM V/68 Administrator's Guide . 
DIAGNOSTICS | 
The accounting system starts complaining with *#*RECOMPILE pnpsplit WITH NEW 
HOLIDA YS##* after the last holiday of the year. See “Accounting” in the SYSTEM V/68 
Administrator's Guide for more on how to correct this condition. Other diagnostics are placed 
in various error and log files. 
BUGS | | 
Normally it is not a good idea to restart runacct in the SETUP state. Run SETUP manually 
and restart via: 
runacct mmdd WTMPFIX 


If runacct failed in the PROCESS state, remove the last ptacct file because it is not complete. 
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NAME 

sadp — disk access profiler 
SYNOPSIS 

sadp [ —th ] [ —d device[ —drive] ] s[n ] 
DESCRIPTION 


Sad p reports disk access location and seek distance, in tabular or histogram form. It samples 
disk activity once every second during an interval of s seconds. This is done repeatedly if n is 
specified. Cylinder usage and disk distance are recorded in units of eight cylinders. 

The only valid value of device is disk. Drive specifies the disk drives and it may be: a drive 
number in the range supported by device, two numbers separated by a minus (indicating an 
inclusive range), or a list of drive numbers separated by commas. 


Up to eight disk drives may be reported. The —d option may be omitted, if only one device is 
present. 


The —t flag causes the data to be reported in tabular form. The —h flag produces a histogram 
of the data on the printer. Default is —t. 
EX AMPLE 
The command: 
sadp —d disk —0 900 4 


generates 4 tabular reports, each describing cylinder usage and seek distance of disk drive 0 
during a 15-minute interval. 


FILES 
/dev/kmem 
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NAME 
sal, sa2, sadc — system activity report package 


SYNOPSIS 
/usr/lib/sa/sadc [t n] [ ofile | 


/usr/lib/sa/sa1 [t n] 
-/usr/lib/sa/sa2 [—ubdycwaqvmA] [—s time] [—e time] [—i sec ] 


DESCRIPTION 7 
System activity data can be accessed at the special request of a user (see sar(1)) and 
automatically on a routine basis as described here. The operating system contains a number of 
counters that are incremented as various system actions occur. These include CPU utilization 
counters, buffer usage counters, disk and tape I/O activity counters, TTY device activity 
counters, switching and system-call counters, file-access counters, queue activity counters, and 
counters for inter-process communications. 


Sadc and shell procedures sa/J and sa2 are used to sample, save, and process this data. 


Sadc, the data collector, samples system data n times every ¢ seconds and writes in binary 
format to ofile or to standard output. If ¢ and n are omitted, a special record is written. This 
facility is used at system boot time to mark the time at which the counters restart from zero. 
The /etc/rc entry: 


su sys —c "/usr/lib/sa/sadc /usr/adm/sa/sa date +%d"" 


Writes the special record to the daily data file to mark the system restart. 


The shell script sa/, a variant of sadc, is used to collect and store data in binary file 
/usr/adm/sa/sadd where dd is the current day. The arguments z and n cause records to be 
written mn times at an interval of ¢ seconds, or once if omitted. The entries in 
/usr/spool/cron/crontabs/sys (see cron(1M)): | 


0 = + = 0,6 /usr/lib/sa/sal 
0 8—17 + = 1—5 /usr/lib/sa/sal 1200 3 
0 18—7 * * 1—5 /usr/lib/sa/sal 


produces records every 20 minutes during working hours; otherwise; it is on an hourly basis. 


The shell script sa2, a variant of sar(1), writes a daily report in file /usr/adm/sa/sardd. 
The options are explained in sar(1). The /usr/spool/cron/crontabs/sys entry 


5 18 * * 1—5 /usr/lib/sa/sa2 —s 8:00 —e 18:01 —i 3600 —A 


reports important activities hourly during the working day. 
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The structure of the binary daily data file is: 


struct sa { 
struct sysinfo si; /* see /usr/include/sys/sysin fo.h */ 
int szinode; /* current entries of inode table */ 
int szfile; /* current entries of file table */ 
int sztext; /* current entries of text table */ 
int szproc; /* current entries of proc table */ 


int mszinode; /* size of inode table */ 

int mszfile; /*x size of file table */ 

int msztext; /* size of text table */ 

int mszproc; /* size of proc table */ 

long inodeovf; /* cumul. over flows of inode table */ 
long inodeovf; /* cumul. over flows of file table */ 
long textovf; /* cumul. over flows of text table */ 
long procovf; /* cumul. over flows of proc table */ 


time t ts; /* time stamp, seconds */ 

long devio[NDEVS] 4k /* device info for up to NDEVS units */ 
#define 10_OPS 0 /* cumul. 1/O requests */ 
#define IO_BCNT 1 /* cumul. blocks trans ferred */ 
#define 10 _ACT 2 /* cumul. drive busy time in ticks */ 
#define 10 RESP 3 /* cumul. I/O resp time in ticks */ 


Is 


FILES 


/usr/adm/sa/sadd daily data file 
/usr/adm/sa/sardd daily report file 
/tmp/sa.adrfl address file 


Sky ALSO 
cron(1M), saeI1G), sar(1), timex(1). 
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NAME 

setmnt — establish mount table 
SYNOPSIS 

/etc/setmnt 
DESCRIPTION 


Setmnt creates the /etc/mnttab table (see mnttab(4)), which is needed for both the 
mount(1M) and umount commands. Setmnt reads standard input and creates a mnttab entry 
for each line. Input lines have the format: 


filesys node 


where filesys is the name of the file system’s special file (e.g., “dsk/?s?”) and node is the root 
name of that file system. Thus, /filesys and node become the first two strings in the 
mnttab(4) entry. 


FILES 

/etc/mnttab 
SEE ALSO 

mount(1M), mnttab(4). 
BUGS 


Filesys or node can be no longer than 10 characters. 
Setmnt silently enforces an upper limit on the maximum number of mnttab entries. 
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NAME 

shutdown — terminate all processing 
SYNOPSIS 

/etc/shutdown 
DESCRIPTION 


Shutdown is part of the SYSTEM V/68 operation procedures. Its primary function is to ter- 
minate all currently running processes in an orderly and cautious manner. The procedure is 
designed to interact with the operator, i.e. the person who invoked shutdown. Shutdown may 
instruct the operator to perform some specific tasks, or to supply certain responses, before exe- 
cution can resume. Shutdown goes through the following steps: 


All users logged on the system are notified to log off the system by a broadcasted message. 
The operator may display his/her own message at this time; otherwise, the standard file- 
save message is displayed. 


If the operator wishes to run the file-save procedure, shutdown unmounts all file systems. 


The super blocks of all file systems are updated before the system is to be stopped (see 
sync(1)). This must be done before re-booting the system, to insure file system integrity. 


DIAGNOSTICS 
The most common error diagnostic that occurs is device busy. This happens when a particu- 
lar file system could not be unmounted. 


SEE ALSO 
mount(1M), sync(1). 
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NAME 
sysdef — system definition. 
SYNOPSIS | 
/etc/sysdef [ opsys [ master ] ] 
DESCRIPTION 


Sysdef analyzes the named operating system file and extracts configuration information; this 
includes al] hardware devices as well as system devices and all tunable parameters. 


The output of sysdef can usually be used directly by config68(1M) to regenerate the 
appropriate configuration files. 


FILES | 
/unix default operating system file © 
/etc/master default table for hardware specifications 
SEE ALSO 


config.68(1M), master(4). 


BUGS 
For devices that have interrupt vectors but are not interrupt-driven, the output of sysdef 
cannot be used for config. Because information regarding config aliases is not preserved by 
the system, device names returned might not be accurate. , 
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NAME 
tic — terminfo compiler 


SYNOPSIS 
tic [—v[n]] file ... 


DESCRIPTION 
Tic translates termin fo files from the source format into the compiled format. The results are 
placed in the directory /usr/lib/terminfo. 


The —v (verbose) option causes tic to output trace information showing its progress. If the 
optional integer is appended, the level of verbosity can be increased. 


Tic compiles all termin fo descriptions in the given files. When a use= field is discovered, tic 
searches first the current file, then the master file, which is ./terminfo.src. 


If the environment variable TERMINFO is set, the results are placed there instead of in 
/usr/lib/terminfo. 


Tic has the following limitations: total compiled entries cannot exceed 4096 bytes, the name 
field cannot exceed 128 bytes. 

FILES 
/usr/lib/terminfo/*/* compiled terminal capability data base 


SEE ALSO 
curses(3X), terminfo(4). 


BUGS 
Instead of searching ./terminfo.src, tic should check for an existing compiled entry. 


TRENTER (1M) | TRENTER (1M) 


NA ME 


trenter — enter a trouble report 
SYNOPSIS 
| trenter [ —s | 
DESCRIPTION 


Trenter resides on any machine that must submit machine- readable trouble reports to Custo- 
mer Support. It prompts the user for the data needed to enter the report, and allows for 
correction of previously entered data, either in-line, or by invoking a text editor. 7renter also 
allows users to specify (in a file) default values for fields that will likely remain constant 
across reports, such as name, address, and company name. In addition, facilities are provided to 
assist loca] administrators in handling trouble report flow on their systems. 


Fields and Values 

Trouble reports consist simply of fields and cesiated values. Each field has a field name, by 
which it may be referenced. When invoked, trenter prompts for values for the trouble 
report’s fields. The following table lists the prompts that are issued, along with their 
corresponding field names. All fields accept one line of input, except for the problem descrip- 
tion, which is a multi-line field, terminated with a line consisting of only a period. The items 
marked with an asterisk (*) are explained below. 


The first nine fields identify the originator of the report. 

Name (NAME) (*) 

Company (CO) (*) 

Phone (PHONE) (*) 

Room Number (ROOM) (*) 

Address (ADDR) (*) 

City (CITY) (*) 

State (STATE) (*) 

Zip Code (ZIP) (*) 

Country (COUNTRY) (*) 

The next two fields are AT&T-assigned numbers to identify the customer and the specific site. 
@e Customer ID (CID) (*) 

@ = Site ID (SID) @) 

The next two fields identify the processor on which the problem occurred. 
@ CPU Serial Number (CPUNO) (*) 

® Machine type (MACH) 

The following fields identify the area in which the problem occurred. 


@ Trouble Report Type (TYPE) 
Valid responses: doc (documentation), enh (enhancement), cs (customer support), fw 
(firmware), hdw (hardware), sw (software), unk (unknown). 


@ WECo Product Name (PROD) 
Examples: UNIX, BASIC 
@ Operating System Release (OS_REL) (*) 
The release of SYSTEM V/68 on which the problem occurred. 


@ Product Release (PROD_REL) | | 
The release of the product given in reponse to the WECo product prompt. If product is 
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unix, this prompt is not issued. 


The remaining fields define the body of the trouble report. 


@ Severity (SEV) 
The severity of the problem (1-4). 


@ Required Date (RDATE) 
If the severity of the report is 2, the required date for the fix is prompted. The date 
given must be at least one week from the date of the trouble report. 


@ Abstract (ABS) 
One-line description of the problem. 


e@ Description (DESC) 
Full description of the problem. Note that description input will not be passed through 
nrof f; however, trenter will recognize the macros .ES and .EE (example start, example 
end), indicating an indented example (these may be nested). 


e Attachments (yes or no) (ATT) 
If ? is given in response to a prompt, a message explaining the field will be printed. 
If trenter receives an interrupt during prompting, the trouble report will be aborted. 


After a trouble report has been completed, the user is given an opportunity to edit any data 
that has been supplied. Next, a reprint of the trouble report just entered may be requested. 
Finally, the user is asked whether another report is to be entered. If so, the values for the 
starred items in the field table above will be carried over from the first report. 


Editing Field Values 

In order to provide editing while responding to prompts, the following escapes are recognized 

on input: 

e —field 
Return to a field for which data has previously been supplied. If the field name is not 
specified, return to the previous field. The value already assigned to the field is printed 
and the user may enter either new data or another editing command. 


© te 
Invoke the editor ed(1) with any text already supplied for the current prompt in the 


edit buffer (an alternate editor can be specified; refer to “Specifying Default Values” 
below). 


® > 
Move down to the first unfilled field. This is useful, for example, when the — com- 
mand has been used to fix a single field near the top of the report and the user wishes to 
quickly return to the point where he/she left off. 


@ =field 
Print the value currently assigned to the given field. 
e ? 


Print a summary of editing functions. 


Editing commands are only recognized when they appear at the beginning of the input line; 
they may be escaped using a backslash ( \ ). 


Specifying Default Values 
Users may provide default values for any fields marked with an asterisk (*) above. . These 
values are specified in a file .trdef in the user’s home directory. Entries in this file are of the 
form: | | 

field=value 
where field is a field name from the table above. 
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FILES 


The editor to be used for field editing can be overridden with a .trdef entry be assigning the 
name of the desired program to the field EDITOR. 


During prompting, trenter will print any values supplied for fields from a .trdef file. By 
default, it will stop at each such field and wait for either a carriage return (indicating confir- 
mation) , an edit command, or new data. If invoked with a —s option, trenter will print the 
supplied values, but will not stop for confirmation. 


Default values specified in .trdef files may be changed, on a per-report basis, using the edit- 
ing functions. described above. 


.trdef default value file 
/usr/spool/tren ter spool directory 
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[AME 
upgrade - software product field upgrade utility 


MESCRIPTION 
The upgrade program is used to install application software products on a computer system 
running SYSTEM V/68, Release 2 or later. 


THIS VERSION OF UPGRADE CANNOT BE USED TO 
INSTALL SOFTWARE DISTRIBUTED ON MEDIA 
CREATED WITH OLDER VERSIONS OF CREATE. 


LXAMPLE 7 
This section describes the interactive dialogue between a user and the upgrade program. 
Indented text represents the program display screens; indented boldface text represents sam- 
ple user input; italicized text represents variable items. Text shown in braces (for example, 
{Yes, No}) represents a choice of responses to the prompts. Any response that is too long is 
truncated; you are then prompted to verify what was entered. Text shown in square brackets . 
({ ]) is commentary that never appears on the screen. ; 


The upgrade program can only be run by the superuser (root) or by setting the owner of the 
upgrade program to root and turning the setuid bit on. Put the system into single-user mode 
and mount the file systems before executing the upgrade program. If you choose to execute 
the upgrade program in multi-user mode, be sure that no other users are logged on. 


To execute the upgrade program, type: 
# upgrade 
The screen displays: 
Software Product Field Upgrade Utility, R3.1 


Copyright 1984,86 by Motorola Computer Systems, Inc. 


What type of media is this product distributed on? 
{Floppy disk, 1.2MB floppy, Tape cartridge, Cartridge disk, 9-track tape} 
o> XXX : , 


Choose the appropriate device name from the list shown in braces; type the device name (or 
the first character of the name), followed by RETURN. Pressing only RETURN causes the 
program to select the first item in the list. An invalid input, such as xxx shown here, pro- 
duces the following error message: 


You must enter the first letter of one of the choices and a RETURN ; 
or just a RETURN to select the first choice. , 
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_ The previous message is then redisplayed. 


What type of media is this product distributed on? 
{Floppy disk, 1.2MB floppy, Tape cartridge, Cartridge disk, 9-track tape} 
-->c¢ [for a cartridge disk] 


Mount distribution media volume #1, then hit RETURN... 
Insert the media into the proper drive and press return. 


A temporary directory is usually created within a file system with enough free space to hold 
the product; by default, /tmp, or /usr/tmp, is used. If there is not enough space, the upgrade 
program asks for another location. Refer to "Selecting a Temporary Directory," below for 
details. | , 


If the target device does not have enough space, the following message is displayed, and the 
program terminates: 


The file system containing the intended target directory 
(target_directory_name) doesn’t have room to hold the product! 
Delete some files, then invoke Upgrade again. 


Tf enough space is available, a subdirectory is created within the temporary directory, 
"_upgrade_ dir," which in most cases already exists. The screen briefly displays: 


mkdir /temp_dir_name/_upgrade_dir 
followed by: 
Software Product Field Upgrade Utility, R3.1 


[1] This product’s name is ’product_name?’ 
Its release identifier is: release_id 
(Auditing facilities use the name: audit name) 
It will occupy about nnnn x [ 512 | 1024]-byte disk blocks in a file system. 


[Ss] | The distribution media is a media_type, 
The product uses nnmn blocks of the media, 
and you should have mn volume(s) of this media. 


Upgrade will execute this command string prior to installation: 
command_string_1 © 
[10] The product will be copied into the temporary directory: 
temp_dir name 
Then it will be moved into the target directory: 
target dir name 
Finally, this command string will be invoked after installation: 
(15) © command_string_2 


Continue... 
(Yes, No} 


on> 
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NOTES: 


1. The byte count shown in line 4 displays either 512- or 1024-byte blocks depending on 
which block size the system uses; the upgrade program automatically selects the appropri- 
ate number for the system. 


2. The media _type in line 5 corresponds to the media type you selected at the first prompt. 


3. The block count (nnnn) in line 6 is based on 1024-byte blocks used on the media. It usu- 
ally does not equal the file system block count shown in line 4. 


4. Lines 8 through 15 may vary from what is shown here. If either command_string_1 or 
command _string_2 is empty, nothing is shown. If there is not enough space for a tem- 
porary copy of the product, lines 10 through 13 are replaced by the statement: 


The product will be copied straight into the directory: 
target_directory_name 


To continue with the upgrade program, type y or press RETURN in response to the "Con- 
tinue... (Yes,No}" prompt. A no (n) response terminates the program. If you type y to con- 
tinue, the screen displays: 


eeann= PRODUCT UPGRADE IN PROGRESS ------ 


Any messages produced by pre-installation commands (command _string_1) are displayed, 
followed by: 


nnnn blocks transferred from volume #1 to temp_dir name... 
If more than one volume is needed, the screen displays: 


‘Mount media volume #n for ’product_name release_ia’, 
then hit RETURN... 


nnnn blocks transferred from volume #2 to temp_dir_ name... 
and so on for each volume of distribution media. 


When all files have been copied into the temporary directory, they are moved into the target 
directory. 


Now moving files into the target directory. 
The name of each file will be displayed as it is copied... 


Individual file names are displayed on the screen: 


file_name_1 


[An nnnn blocks message is also displayed here but should be ignored!] 
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The temporary directory created earlier is removed, and the screen displays: - 
rm -rf /temp_dir_name/_upgrade_dir 


A table-of-contents listing for this product is contained in: 
"audit name’ 


‘Would you like me to generate audit files for this product installation now? 
{Yes, No} 
--> 1 


A yes (y) response causes the program to generate audit files; for details on auditing, telat to 
"Performing an Installation Audit,” below. 


A no (n) response produces the following message: 

You can use ’upgrade -a’ to do the audit later! 
For details on using upgrade aa: refer to "Performing an Installation Audit," below. 
When the upgrade is complete, the screen displays: 

Finished upgrading ’product_name (release _id)’. 


Do you wish to upgrade another product? 
{No, Yes} | 
-> [A RETURN is sufficient to terminate program execution.] 


SELECTING A TEMPORARY DIRECTORY 
This section describes how the upgrade program responds when there is not enough space in 
either /tmp or /usr (for /usr/tmp) to hold a temporary copy of the product. (NOTE: /tmp is 
_ selected as a temporary directory only if itis a SEPARATE FILE SYSTEM in the system! If 


it is a directory beneath root, it cannot be selected! Use the df command to display all file 
system names.) 


1. This first dialogue occurs if none of the file systems have enough space: 


Does a previous version of this product already exist in your system? 
{No, Yes} 


--> y [If you answer no (n), the product cannot be loaded, and the program 
terminates. ] 


In order to install this new version, I’ll have to write over 
the old version. Do you want to do this? 

{Yes, No} 

--> y [A no (n) terminates the program] 


me 
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Is the old version located in the ’target_dir’ directory? 

(Yes, No} 

--> n [Type no (n) if the old version of the product’s files was moved since it was 
installed. ] 


Enter the name of the directory where it is located: 
--> xyz [Enter a directory pathname.] 


This response is checked to be sure that a valid directory was specified. tt not, an error 
message and the previous message are displayed: 


*xyz’ is not a valid directory! 
Enter the name of the directory where it is located: 
--> [A valid directory pathname must be entered.] 
2. The following dialogue occurs if at least one file system (other than /tmp and /usr) 


has enough space to hold a temporary copy of the product. 


These file systems have enough room to install this peur 
(>blocks needed): 


file_sys_1  blocks_free 


[Other names are shown if applicable.] 
For each file system shown, you are prompted: 
Do you want to use ’file_sys_n’ for holding a temporary copy of the product? 
{No, Yes} 


on 


A no (n) response or RETURN causes the next possible choice to be offered. If all choices 
are declined, the following prompt is displayed and the process repeats: 


YOU MUST SELECT ONE OF THESE DEVICES! 


If you select a file system other than root (/), you can specify a subpath within the selected 
filesystem. 


Enter a subdirectory within this file system, if desired. 
--> /file_sys_name/xyz 
[The selected file_sys_name is shown as part of the prompt. 


RETURN is usually a sufficient response because the name, ’/_upgrade_ dir,’ is appended 
to the end of the resulting name. 
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If a nonexistent directory name, such as xyz is entered, the screen displays: 
*xyz’ is not a valid directory! 


Enter a subdirectory within this file system, if desired. 
--> /file_sys_name/ 


PERFORMING AN INSTALLATION AUDIT 
If the audit files have not been deleted, an audit can be performed by executing upgrade -a 
once the product has been installed. The upgrade -a program asks for the type of media the 
product is distributed on and for the first volume to be installed. The program then moves 
directly to the audit section and displays: 


--- NOW EXTRACTING CRC’S FROM PRODUCT FILES --- 
This may take a minute or two... please be patient! 
The following files contain auditing data for this product: 


The names of three files appear on the screen in Is -l format. The information in them will be 
needed if you ever call the Customer Support Operation for assistance. The files should be 
printed and saved in a convenient place (for example, with the distribution media), then 
deleted. They can be reconstructed by executing upgrade again. 


The three files are named after. the audit_name identified in the status display: 
audit_name.cr0, audit _name.crc, and audit_name.js. For simplicity, they are referred to here 
as *.cr0, *.crc, and *.ls, respectively. (Note that the audit_name is different for each product.) 


These files use two different formats. The *.ls file format is similar to that produced by an ls 
command. It contains the name of every file installed as part of the product. The * crO and 
* crc files use the following format: 


Scere length modification time-stamp __ file name 


for each of the files identified in the corresponding *ls file. The *.cr0 file is created at the 
factory when the distribution media is created. The *.cre file is created by this part of the 
program when the upgrade program is run or when executing upgrade -a. It can also be 
created by typing: 


cre -cdf /usr/AUDITS/audit_name.ls >/usr/AUDITS/audit_name.cre 


The first three fields of the *.cr0 and *.crc files should be identical for every corresponding 
file name (see NOTE below). The fourth columns ‘should differ only in their path prefixes; 
that is, the *.crO file might display its file names as /x/y/example, while the *.crc file shows 
/a/b/c/example for every file example. This causes corresponding *.cr0 and *.cre files to 
have different lengths, even when the data in the first three columns is identical for each 
entry. | - 


NOTE: Due to the operation of cpio, the *.ls and * cre files may contain a few more entries 
than their corresponding *.cr0 file. If present, these entries represent DIRECTORY 
NAMES rather than file names. 
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A short shell function, audit, can be used to perform a simple audit of these files. To create 
audit, type the following lines after a shell prompt. 


# audit() { 

> sort /usr/AUDITS/$1.cr? | 

> awk ’BEGIN { FS = “\t" } 

> { print $4 "\t" $1 "\t" $2 "\t" $3 }’ | 

> uniq -u-1 [Use the digit one, not the lowercase letter L.] 
>} 

# 


This shell function is executed as if it were a shell script and is stored in memory rather than 
in a file. It disappears after you log off, and cannot be exported to nested shells. It 1s 
invoked by typing audit audit_name to the shell, where audit name is the name given in line 
3 of the status display (see page 2). For.example, audit can be used to audit the files for a 
product named "menus" by typing: 


# audit menus 
or 


If the upgrade installation executes properly, this command returns a shell prompt. Any file 
that doesn’t transfer properly has its name, crc, length, and modification date displayed. If 
just one line for each name appears, it will usually be from the *.cr0 file and indicate that the 
corresponding file was not installed in the system properly or was erased. If two lines for 
each name appear, then one or more of the last three fields differs. Generally, it will be the 
modification time-stamp field that differs. However, if an error occurred during installation,. 
the crc and/or length fields may differ; in this case, do a complete reinstallation. 


TAGNOSTICS 
Most parameters are validated before being used, either by the program or by the user via the 
Status display. It is possible, however, for an internally executed shell command to die, in 
which case an error message may or may not be produced. Known error conditions fall into 
two categories: warnings and fatal errors. Warnings produce a message but allow for contin- 
ued execution. Fatal errors prévent complete installation from the distribution media. Warn- 
ing and fatal error messages are listed below. 


If the /usr/bin/cre program is missing, abort upgrade and rerun after the erc program is 
located and installed. 


Warnings 
The checksums don’t match for this volume! 


error encountered while reading checksum from distribution media! 
popen failed; can’t determine available space! 


can’t accurately determine block-size of target device! 
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Fatal Errors | | | | | | 
You must be logged in as root or have root’s setuid permission set! 


There is NOT SUFFICIENT SPACE on your system to install this product! 


I can’t read this media! (incompatible internal structure) 
The media was created with an earlier version of the create program. 


Can’t open device {dev_name} for reading! 
| Verify that the virtual device names are linked properly: 


/dev/FLOPPY _ for raw floppy device (640K bytes) 
/dev/FLOPPY.MB for raw 1.2MB floppy device 
/dev/ITOMEGA for raw 5MB Iomega cartridge disk 


/dev/TAPE.CART for cartridge tape drive 
/dev/TAPE.STRK . for 9-track tape drive | 


You'll have to (re)install this product before auditing! 
Some audit files are missing. Run upgrade again without the -a switch. 


can’t read header from distribution media! 
error reading from distribution media! 
error writing to cpio data stream! 


can’t popen output stream! — 


FILES 
tput(1) 
/usr/bin/ere 


41968-51 a aes : 09/09//86 


UUCLEAN (1M) 


NAME 


UUCLEAN(1M) 


uuclean — uucp spool directory clean-up 


SYNOPSIS 


/usr/lib/uucp/uuclean [ options ] 


DESCRIPTION 


Uuclean scans the spool directory for files with the specified prefix and deletes all those 
which are older than the specified number of hours. 


The following options are available. 


—ddirectory Cleans directory instead of the spool directory. 


—ppre 


—ntime 


~wfile time 


—SSYS 


—mfile 


FILES 


Scans for files with pre as the file prefix. Up to 10 —p arguments may be 
specified. A —p without any pre following causes all files older than the 
specified time to be deleted. 


Deletes files whose age is more than time hours, if the prefix test is satisfied. 
(default time is 72 hours) 


Finds files which are older than time hours; however, the files are not deleted. 
If the argument file is present, the warning is placed in file; otherwise, the warn- 
ings go to the standard output. 


Examines only files destined for system sys. Up to 10 —s arguments may be 
specified. 


Sends mail to the owner of the file when it is deleted. If a file is specified, then 
an entry is placed in file. 


This program is typically started by cron(1M). 


/usr/lib/uucp (directory with commands used by uuclean internally) 


/usr/spool/uucp (spool directory) 


SEE ALSO 


cron(1M), uucp(1C), uux(1C). 
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NAME 


uusub — monitor uucp network 


SYNOPSIS 


/usr/lib/uucp/uusub [ options ] 


DESCRIPTION 


Uusub defines a uucp subnetwork and monitors the connection and traffic among the 
members of the subnetwork. The following options are available: 


—asys Add sys to the subnetwork. 
—dsys Delete sys from the subnetwork. 


—] Report the statistics on connections. 
—r Report the statistics on traffic amount. 
—f Flush the connection statistics. 


—uhr Gather the traffic statistics over the past hr hours. | 
—csys Exercise the connection to the system sys. If sys is specified as all, then exercise the 
connection to all the systems in the subnetwork. 


The meanings of the connections report are: 
sys #call #ok time #dev #login #nack #other 


where sys is the remote system name, #call is the number of times the local system tries to 
call sys since the last flush was done, #ok is the number of successful connections, time is the 
latest successful connect time, #dev is the number of unsuccessful connections because of no 
available device (e.g., ACU), #login is the number of unsuccessful connections because of login 
failure, #nack is the number of unsuccessful connections because of no response (e.g., line 
busy, system down), and #other is the number of unsuccessful connections because of other 
reasons. 


The meanings of the traffic statistics are: 
sy file sbyte r file rbyte 


where s/ile is the number of files sent and sbyte is the number of bytes sent over the period 
of time indicated in the latest wuswb command with the —uhr option. Similarly, r/ile and 
rbyte ‘are the numbers of files and bytes received. 


‘The command: 
uusub —c all —u 24 


is typically started by cron(1M) once a day. 


FILES 
/usr/spool/uucp/SYSLOG | system log file 
/usr/lib/uucp/L_sub connection statistics 
/usr/lib/uucp/R_sub traffic statistics 

SEE ALSO 


uucp(1C), uustat(1C). 
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NA ME 


vm22fmt — format disks on the VM22 disk controller 


SYNOPSIS 


/etc/vm22fmt [| —h starthead] [—t trkcyl] [—e sectrk ] [—r steprate] [—a attr] 

[—g gpl3] [ —1 spiral ] [—c cyls ] [—p precomp ] [ —s secsiz ] [—x] [—F] special 
DESCRIPTION 

Vm22fmt is used to format disks on the VM22 disk controller. This disk controller requires 

the following information to format the disk: 


@® starting head number of the drive. 
tracks per cylinder. 

drive step rate. 

drive I/O attribute byte. 

drive GPL3 code. 

spiral offset to use. 

cylinders per drive. 
precompensation cylinder. 

@ sector size in bytes per sector. 


Each of these parameters can be set by the appropriate command option. The options are: 


—h Starting head number. All drives have starting head number zero except the fixed disk 


—E 


—s 


—] 


on LMD (Lark) and CMD drives. Default: 0. The fixed LMD drive has starting head 
number 2. The fixed CMD drive has starting head number 16. 


Tracks per cylinder (heads). Default: 2. LMD disks all have 2 heads. All 16Mb CMD 
drives have 1 head. The 80Mb CMD drive has 5 heads. Single-sided floppies have 1 
head while double-sided ones have 2. 


Sectors per track. Default: 64. All hard disks have 64 sectors per track. The 8-inch 
floppies have 26 sectors per track: while 5% inch floppies have 16 sectors per track. 


Step rate. A step rate of zero informs the VM22 to use its built-in default step rate for 
that drive. Default: 0. Only specify a different step rate after carefully studying the 
VM22 User’s Manual. 


Attribute byte. The attribute byte is used during normal read and write commands to 
the VM22. Default: 9. The bits of the attribute byte are shown in the table at the end 
of this section (refer also to the VM22 User’s Manual). 


VM22 GPL3 parameter (floppy only). This parameter determines the number of bytes 
inserted after the data field on each sector to compensate for motor speed variation. If 
this parameter is zero, the controller will use the correct default for the present confi- 
guration. Default: 0. Only specify a different gpl3 after carefully studying the VM22 
User’s Manual. 


Spiral offset. Defines the physical sector in which the first logical sector of a track 
appears. Default: 0. 


Cylinders. Default: 624. The LMD drives have 624 cylinders. The CMD drives have 
823 cylinders. The 8-inch floppies have 77 cylinders. The 5¥%-inch floppies have 80 
cylinders. 


Precompensation cylinder (Floppy only). Default: 0. The precompensation cylinder is 
usually set to be the number of cylinders divided by two. 


Sector size. Default: 256. On floppies, the sector size for single-density is 128 bytes. 
Double-density sector size is 256 bytes. 


In addition, the —x option will print out example command line options for various VM22 
compatible disk drives and a list of the default settings. Lastly, the —F option tells vm22 fmt 
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FILES 


to set the disk configuration but not format the disk. This option is used when the disk confi- 
guration block on the disk is incorrect and needs to be overwritten. When formatting flop- 
ples, vm22 fmt will always format the first track of the floppy as single-density, 128 bytes 
per sector. This track is used for holding the disk configuration information. The default set- 
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tings are for a CDC 9457 25Mb LMD (Lark) cartridge. 


/dev/dsk/* 
/dev/rdsk/* 


/etc/diskdefs — 
/etc/diskalts/vm22* 


SEE ALSO 
dinit(1M), cm16(7), cm80(7), £18(7), Irk(25), vm22(7). 
Storage Module Drive Disk Controller User’s Manual, M68K VM22/D1 


BITS OF ATTRIBUTE BYTE 
USE 


Floppy Track Density (Floppy Only). 
if O - drive and media density the same. 
if 1 - media is 1/2 drive density 
(i.e., 96 TPI drive and 48 TPI media). 


Floppy Sector Numbering (Floppy Only). 

if O - sectors number 1-N on both sides (IBM). 
if 1 - Motorola format, 1 to N on side O 

and N+1 to 2N on side 1. 


Floppy recording method (Floppy Only). 
if O - FM (single-density). 
if 1 - MFM (double-density). 


Sector Size Code. 

if OO - 128 bytes per sector. 
if 01 - 256 bytes per sector. 
if 10 - $12 bytes per sector. 
if 11 - 1024 bytes per sector. 


Floppy Diskette Sides (Floppy Only). 
if O - single-sided. 
if 1 - double-sided. 


Floppy Data Rate (Floppy Only). 
if O - 5Y4-inch data rate (250 kilobits per second). 
if 1 - 8-inch data rate (500 kilobits per second). 


Imbedded Servo Drive (SMD only). 

if O - Drive does not require a seek when a 
head switch is performed. 

if 1 - Drive requires a seek when a head switch 
is performed. (Used for LARK and 
LARK-compatible drive.) 
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DIAGNOSTICS 
DIAGNOSTIC 
Can’t stat <special > 
<special > not a raw disk 
Can’t open <special > 
vm22fmt: configuration error 
vm22fmt: format unit failure 
vm22fmt: format track failure 
BUGS 
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line nonexistent. Create file. 


Special file given on command 
line must be a character special 
file. Be sure the correct file is 
being used. 


Could not open special file given 
on command line for read/write. 
Check modes of special file. 


Could not successfully set the 
drive configuration. Check com- 
mand line options for incompati- 
ble configuration information 


(e.g., if the sector size information — 
in the attribute byte disagrees 

with the sector size option, then 

the configuration will fail). 


The “format unit” command to 
format the entire disk failed. The 
system console should have an 
error message on it that will indi- 
cate the nature of the problem. 
That message is generated by the 
disk driver’s error message rou- 
tine. Refer to the SYSTEM V/68 
Error Message Manual for more 
information. 


The “format track” command to 
format the first track failed. The 
system console should have an 
error message on it that will indi- 
cate the nature of the problem. 
That message is generated by the 
disk driver’s error message rou- 
tine. Refer to the SYSTEM V/68 
Error Message Manual for more 


| information. 


The default setting on the configuration items is for a 25Mb LMD cartridge. When format- 
ting any other media type, be careful to supply the correct options. Use the —x option for 
some examples; also, refer to the VM22 User’s Manual for more details. 
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NAME 


volcopy, labelit — copy file systems with label checking 


SYNOPSIS 


/etc/volcopy [options] fsname speciall volnamel special2 volname2 


/etc/labelit special [ fsname volume [ —n ] ] 


DESCRIPTION 


Volcopy makes a literal copy of the file system using a blocKsize matched to the device. 
Options are: , 


—a invoke a verification sequence requiring a positive operator response instead of 
the standard 10 second delay before the copy is made, : 
=—S (default) invoke the DEL if wrong verification sequence. 


Other options are used only with tapes: 
—bpidensity bits-per-inch (i.e., 800/1600/6250), 
—feetsize size of reel in feet (i.e., 1200/2400), 
—reelnum _ beginning reel number for a restarted copy, 
—buf use double buffered I/O. 


The program requests length and density information if it is not given on the command line 
or is not recorded on an input tape label. If the file system is too large to fit on one reel, vol- 
copy prompts for additional reels. Labels of all reels are checked. Tapes may be mounted 
alternately on two or more drives. If volcopy is interrupted, it will ask if the user wants to 
quit or wants a shell. In the latter case, the user can perform other operations (e.g, labelit) 
and return to volcopy by exiting the new shell. © | 


The /srame argument represents the mounted name (e.9., root, ul) of the file system being 
copied. 


The special argument should be the physical disk section or tape (e.g., /dev/rdsk/cnirlr_1s5 
or /dev/rmt/cnirlr_ Om). 


The volname is the physical volume name (e.2., pk3, t0122, etc.) and should match the exter- 
nal label sticker; such label names are limited to six or fewer characters. Volnarmne may be — 
to use the existing volume name. 


Special] and volname/ are the device and volume from which the copy of the file system 1s 
being extracted. Special2 and volname2 are the target device and volume. 


Fsname and volume are recorded in the the superblock (char fsname[6], volnamel6 ). 


Labelit can be used to provide initial labels for unmounted disk or tape file systems. With 
the optional arguments omitted, labelit prints current label values. The —n option provides 
for initial labeling of new tapes only (this destroys previous contents). 


FILES 

/etc/log/filesave.log (a record of file systems/volumes copied). 
SEE ALSO 

fs(4). 
BUGS 


If the —buf option is selected, volcopy will core dump if it gets to the end-of-tape. 


WALL(1M) | | WALL( 1M) 


NAME 
wall — write to all users 


SYNOPSIS 
/etc/wall 


DESCRIPTION 


Wall reads its standard input until an end-of-file. It then sends the message to all currently 
logged in users preceded by: 


Broadcast Message from... 
It is used to warn al] users, typically prior to shutting down the system. 


The sender must be superuser to override any protections the users may have invoked (see 
mesg(1)). 

FILES 
/dev/tty* 


SEE ALSO 
mese(1), write( ). 


DIAGNOSTICS 
“Cannot send to...” when the open on a user’s ¢ty file fails. 


-WFEMT (1M) | : | WFEMT (1M) 


NA ME 


wffmt — format floppies for the VME/10 processor 


SYNOPSIS 


wffmt device 


DESCRIPTION 


FILES 


The wf fmt utility is used to format 5¥4-inch floppy diskettes for the VME/10. The user 
specifies a raw device that is a floppy drive. In the basic configuration, this will be 
/dev/rdsk/cntrir_2s7. If a second floppy drive is connected, it has the device name 
/dev/rdsk/cntrir_3s7. When the command 

wffmt /dev/rdsk/cntrir_2s7 
is given, the following message appears on the screen: 

Formatting floppy in /dev/rdsk/cntrir_2s7 
When the SYSTEM V/68 prompt appears on the screen, formatting is complete. 


W f fmt checks to make sure that a correct device name is specified. The following diagnostic 
messages may appear if the command is incorrect: 


Cannot stat/access /dev/device name The device specified is not connected 
or permissions are incorrect. 


Not a floppy drive. The number given was not 
rdsk/cntrir_2s7 or rdsk/cntrir_3s7. 


Must use a raw/character device. The correct specification is 
| rdsk/, not dsk/. 


/etc/wffmt 


WHODO(1M) WHODO( 1M ) 


NAME 

whodo — who is doing what 
SYNOPSIS 

/etc/whodo 
DESCRIPTION 


Whodo produces merged, reformatted, and dated output from the who(1) and ps(1) com- 
mands. 


SEE ALSO 
ps(1), who(1). 


at 


INTRO(7) | INTRO(7) 


NA ME 
intro — introduction to special files 


DESCRIPTION | 
This section describes various special files that refer to specific hardware peripherals and 
SYSTEM V/68 device drivers. The names of the entries are generally derived from names for 
the hardware, as opposed to the names of the special files themselves. Characteristics of both 
the hardware device and the corresponding SYSTEM V/68 device driver are discussed where 
applicable. 


SYSTEM V/68, Release 2, Version 1 incorporates a new convention for naming disk and tape 
devices. In earlier releases, the standard format for naming disk devices was /dev/dkxy 
where x referred to the disk device number and y referred to the disk section or partition. 
Raw access to a disk device was indicated with an r, e.g., /dev/rdk0O1. Standard format for 
naming tape devices was /dev/mtx where x referred to the magnetic tape device number. 
Raw access to a tape device was indicated with an r, e.g., /dev/rmt0. 


The new naming convention creates separate subdirectories under /dev for each type of disk 
or tape device. The new format for disk devices is: 


/dev/ {r} dsk/ [ r ] [ cntrir_ ] [ controller_numberd | drive_numberssection_number 


Fields in square brackets are entirely optional: they do not affect the operation of any 
software or hardware; they are for informational purposes only, for the convenience of 
administrators, operators, and users. Fields in curly brackets represent options that affect 
software; they must be present if that option is being selected. 


r (Not Required) (The first r) indicates a raw interface to the disk. 
The default is normal system buffering. 

dsk/ (Required) Indicates that the device is a disk. 

r (Not Required) (The second r) indicates that this disk is on a remote 
system. 

cntrir— (Not Required) Indicates the appropriate disk device in systems with 


multiple disk drivers. In Release 2, Version 1 of SYSTEM V/68, the 
controller names are present and must be used on command lines 
that specify a disk device. The disk devices available are: 


vm21_ Intelligent Universal Disk Controller, M68KVM21 


vm22_ Intelligent SMD Disk Controller with Floppy Disk, 
M68K VM22 


wd_ Winchester Disk Controller, M68RWIN1 
ud— General Universal Disk Controller 


c Generic Controller 


controller_numberd (Not Required) System administrators decide whether or not to 
specify the controller number in the disk device name. If the con- 
troller number is specified, the d introduces the drive number. 


drive_number (Required) The drive number. The field is free format; there is no 
default drive number. 


ssection_number (Required) The section number. The field is free format; there is no 
default section number. 


INTRO(7) | | INTRO(7) 


BUGS 


As an example, the name for disk drive 0, section 0 might be /dev/dsk/vm22_0s0. 
The new format for tape device names is: | 
/dev/ {r} mt/ [ ccontroller_numberd ] d rive_numberdensity { n } 


where: 

r | (Not Required) Indicates a raw device. The default is a blocked dev- 
ice. | : 

mt/ (Required) Indicates a magnetic tape device. 


ccontroller_numberd (Not Required) The c introduces the controller number. System 
administrators decide whether or not to specify the controller 
number in the tape device name. If the controller number is speci- 
fied, the d introduces the device number. 


device_number (Required) The drive number. The drive number is followed 
immediately by the density value of the tape. 


density (Required) Tape density must be specified for each drive. The den- 
sity is indicated with an h, m, or 1, where: 


h (high) is a tape density of 6250 bpi 
m (medium) is a tape density of 1600 bpi 


1 Cow) is a tape density of 800 bpi 


n (Not Required) Indicates no rewind on close. The default condition is 
| to rewind. 


As an example, the name for a 6250 bpi magnetic tape drive might be /dev/mt/Oh. 


_ To ensure a smooth transition, old device names are accepted by the SYSTEM V/68 Release 2 


software. However, all documentation and sample shell scripts distributed with this release 
use the new naming convention. System administrators are encouraged to rename existing 
devices and incorporate the new names into shell scripts as soon as possible. 


The following table compares existing device filenames with the new filenames that will be 


found in the documentation. 


Disk Devices Tape Devices 
Old Tape Name _| New Tape Name_ 
dev/mt/Ol 
dev/mt/Smn 
|/dev/rdk00 | /dev/rdsk/cntrir_0s0| 


While the names of the entries generally refer to vendor hardware names, in certain cases 
these names are seemingly arbitrary for various historical reasons. . 


~ 


ACIA (7) ACIA (7) 


NAME 
acia — Asynchronous Communications Interface Adapter 


DESCRIPTION 
Each line attached to an acia behaves as described in termio(7). The EXORmacs debug module 
and up to five quad communications modules (M68K V7) are supported. The line speed of the 
EXORmacs debug module can be changed under software control (output speed = input 
speed), while the line speed of the quad communications modules can be changed by hardware 
strapping. Eight combinations of data bit, stop bit, and parity bit options are supported (refer 
to stty(1)). 


FILES 
/dev/console /dev/tty* 


SEE ALSO 
stty(1), termio(7). 


CM16(7) 7 CM16(7) 


NAME 
cm16 — 16Mb Cartridge Module Drive for Universal Disk Driver 


DESCRIPTION | 
The files dsk/cntrir_0sO ... dsk/cntrir_Os7 refer to sections of the CM16 disk drive 0. The 
files dsk/cntrir_1s0 ... dsk/cntrir_1s7 refer to sections of drive 1. This slicing allows the 
pack to be broken up into more manageable pieces. | 


The origin and size of the sections on each drive are as follows: 


section start length 


0 O 26336 
1 3292 23044 
2 6584 19752 
3 9876 16460 
4 13168 13168 
5 16460 9876 
6 19752 6584 
7 23044 3292 


The start address is a block address, with each block containing 512 bytes. Since there is over- 
lap, it is unwise for all of these files to be present in one installation. 


The dsk/* files access the disk via the system’s normal buffering mechanism and may be read 
and written without regard to physical disk records. There is also a “raw” interface which 
provides for direct transmission between the disk and the user’s read or write buffer. A sin- 
gle read or write call results in exactly one I/O operation and therefore raw I/O is consider- 
ably more efficient when many words are transmitted. The names of the raw files begin 
with rdsk/ and end with a number that selects the same disk section as the corresponding 
dsk file. 


In raw I/O the buffer must begin on a word boundary, and counts must be a multiple of 512 
bytes (a disk block). Likewise, lseek(2) calls should specify a multiple of 512 bytes. 


FILES 
/dev/dsk/s, /dev/rdsk/* 


SEE ALSO | 
ud(7), cm80(7), 1rk25(7), £18(7). 


CMs80(7) CM80(7 ) 


NAME 
cm80 — 80Mb Cartridge Module Drive for Universal Disk Driver 


DESCRIPTION 
The files dsk/cntrir_OsO ... dsk/cntrir_Os7 refer to sections of the CM80 disk drive 0. The 
files dsk/cntrir_1s0 ... dsk/cntrir_1s7 refer to sections of drive 1. This slicing allows the 
pack to be broken up into more manageable pieces. 


The origin and size of the sections on each drive are as follows: 


section start length 
0 0 26336 
1 26336 26336 
2 52672 26336 
3 79008 13168 
4 92176 13168 
5 105344 13168 
6 118512 13168 


7 QO 131680 


The start address is a block address, with each block containing 512 bytes. Since there is over- 
lap, it is unwise for all of these files to be present in one installation. 


The dsk/* files access the disk via the system’s normal buffering mechanism and may be read 
and written without regard to physical disk records. There is also a “raw” interface which 
provides for direct transmission between the disk and the user’s read or write buffer. A sin- 
gle read or write call results in exactly one I/O operation and therefore raw I/O is consider- 
ably more efficient when many words are transmitted. The names of the raw files begin 
with rdsk and end with a number which selects the same disk section as the corresponding 
dsk file. 


In raw I/O the buffer must begin on a word boundary, and counts must be a multiple of 512 
bytes (a disk block). Likewise, lseek(2) calls should specify a multiple of 512 bytes. 


FILES 
/dev/dsk/*, /dev/rdsk/* 


SEE ALSO 
ud(7), cm16(7), 1rk25(7), £18(7). 


CMD16(7) CMD16(7) 


NA ME 


cmd16 — 16Mb Cartridge Module Drive for VM21 Driver and VM22 Driver 


DESCRIPTION 


FILES 


The files dsk/cntrir_OsO ... dsk/cntrir_Os7 refer to sections of the CMD16 disk drive 0. The 
files dsk/cntrir_1sO ... dsk/cntrir_1s7 refer to sections of drive 1. This slicing allows the 
pack to be broken up into more manageable pieces. This new slicing also allows space on the 
disk for replacement tracks to be used by the software bad track replacement scheme. 


The origin and size of the sections on each drive are as follows: 


section start length 


0 7 25984 
1 107 22784 
2 207 19584 
3 307 16384 
4 407 13184 
5 507 9984 
6 607 6784 
7 0 26336 


The start address is a cylinder address. The length is expressed in blocks, with each block con- 
taining 512 bytes. Since there is overlap, it is unwise for all of these files to be present in one 
installation. Information about recommended file system partitioning is provided in the 
“Administrative Guidelines” section of the SYSTEM V/68 Administrator's Guide. 


The dsk/* files access the disk via the system’s normal buffering mechanism and may be read 
and written without regard to physical disk records. There is also a “raw” interface which 
provides for direct transmission between the disk and the user’s read or write buffer. A sin- 
gle read or write call results in exactly one I/O operation and therefore raw I/O is consider- 
ably more efficient when many words are transmitted. The names of the raw files begin 
with rdsk and end with a number that selects the same disk section as the corresponding dsk 
file. 


In raw I/O, the buffer must begin on a word boundary, and counts must be a multiple of 512 
bytes (a disk block). Lseek(2) calls should specify a multiple of 512 bytes. 


/dev/dsk/*#, /dev/rdsk/* 


SEE ALSO 


cmd8Q(7), lark25(7), lark8(7), sa800f121(7), sa800f122(7), vm21(7), vm22(7). 


CMD80(7) CMD80(7) 


NA ME : 
cmd80 — 80Mb Cartridge Module Drive for VM21 Driver and VM22 Driver 


DESCRIPTION | 
The files dsk/cntrir_0sO ... dsk/cntrir_Os7 refer to sections of the CMD80 disk drive 0. The 
files dsk/cntrir_1sO ... dsk/cntrir_1s7 refer to sections of drive 1. This slicing allows the 
pack to be broken up into more manageable pieces. This new slicing also allows space on the 
disk for replacement tracks to be used by the software bad track replacement scheme. 


The origin and size of the sections on each drive are as follows: 
section start length 


0 6 130080 
1 126 =110880 
2 333 77760 
3 495 51840 
4 576 38880 
> 657 25920 
6 738 12960 
7 QO 131680 


The start address is a cylinder address. The length is expressed in blocks, with each block con- 
taining 512 bytes. Since there is overlap, it is unwise for all of these files to be present in one 
installation. Information about recommended file system partitioning is provided in the 
“Administrative Guidelines” section of the SYSTEM V/68 Administrator's Guide. 


The dsk/* files access the disk via the system’s normal buffering mechanism and may be read 
and written without regard to physical disk records. There is also a “raw” interface which 
provides for direct transmission between the disk and the user’s read or write buffer. A sin- 
gle read or write call results in exactly one I/O operation and therefore raw I/O is consider- 
ably more efficient when many words are transmitted. The names of the raw files begin 
with rdsk and end with a number which selects the same disk section as the corresponding 
dsk file. 


In raw I/O, the buffer must begin on a word boundary, and counts must be a multiple of 512 
bytes (a disk block). Lseek(2) calls should specify a multiple of 512 bytes. 

FILES 
/dev/dsk/s*, /dev/rdsk/* 


SEE ALSO 
cmd16(7), lark25(7), lark8(7), sa800f121(7), sa800f122(7), vm21(7), vm22(7). 


ERR(7) | | ERR(7) 


NAME 
err — error-logging interface 


DESCRIPTION | 
Minor device O of the err driver is the interface between a process and the system’s error- 
record collection routines. The driver may be opened only for reading by a single process 
with superuser permissions. Each read causes an entire error record to be retrieved; the record 
is truncated if the read request is for less than the record’s length. 


FILES 
/dev/error special file 


SEE ALSO 
errdemon(1M). 


FL8 (7) | | FL8(7) 


NAME 
£18 — 8-inch Floppy Disk Drive for Universal Disk Driver 


DESCRIPTION 
Although it is possible to have 8 devices for each floppy disk drive, only two devices per 
floppy disk drive are currently defined: dsk/cnirir_xs0 and dsk/cntrir_xs1 


Dsk/cntrir_xs0 is defined for single-sided drives or single-sided disks in double-sided drives. 
Dsk/cntrlr_xs1 is defined for double-sided disks in double-sided drives. 


The origin and size of the sections on each drive are as follows: 


section start length 
0 500 
0) 1000 


NOM Bh WNY = © 
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The start address is a block address with each block containing 512 bytes. Since there is over- 
lap, it is unwise for all of these files to be present in one installation. 


The dsk/* files access the disk via the system’s normal buffering mechanism and may be read 
and written without regard to physical disk records. There is also a “raw” interface which 
provides for direct transmission between the disk and the user’s read or write buffer. A sin- 
ele read or write call results in exactly one I/O operation and therefore raw I/O is consider- 
ably more efficient when many words are transmitted. The names of the raw files begin 
with rdsk and end with a number that selects the same disk section as the corresponding dsk 
file. 

In raw I/O the buffer must begin on a word boundary, and counts must be a multiple of 512 
bytes (a disk block). Likewise, lseek(2) calls should specify a multiple of 512 bytes. 


FILES 
/dev/dsk/*, /dev/rdsk/* 


SEE ALSO 
ud(7), cm16(7), em80(7), 1rk25(7). 


LARK8(7) . LARK8(7) 


NA ME 


lark8 — 16Mb LARK Module Drive for VM21 Driver and VM22 Driver 


DESCRIPTION 


FILES 


The files dsk/cntrir_OsO ... dsk/cntrir_Os7 refer to sections of the LARK25 disk drive 0. 
The files dsk/cntrir_1s0 ... dsk/cntrir_1s7 refer to sections of drive 1. This slicing allows 
the pack to be broken up into more manageable pieces. This new slicing also allows space on 
the disk for replacement tracks to be used by the software bad track replacement scheme. 


The origin and size of the sections on each drive are as follows: 


section start length 


0) 4 12736 
1 29 =: 11136 
2 54 9536 
3 79 7936 
4 104 6336 
S 129 4736 
6 154 3136 
1 O 13184 


The start address is a cylinder address. The length is expressed in blocks, with each block con- 
taining 512 bytes. Since there is overlap, it is unwise for all of these files to be present in one 
installation. Information about recommended file system partitioning is provided in the 
“Administrative Guidelines” section of the SYSTEM V/68 Administrator's Guide. 


The dsk/* files access the disk via the system’s normal buffering mechanism and may be read 
and written without regard to physical disk records. There is also a “raw” interface which 
provides for direct transmission between the disk and the user’s read or write buffer. A sin-_ 
gle read or write call results in exactly one I/O operation and therefore raw I/O is consider- 
ably more efficient when many words are transmitted. The names of the raw files begin 
with rdsk and end with a number which selects the same disk section as the corresponding 
dsk file. | | 


In raw I/O, the buffer must begin on a word boundary, and counts must be a multiple of 512 
bytes (a disk block). Lseek(2) calls should specify a multiple of 512 bytes. 


/dev/dsk/s, /dev/rdsk/* 


SEE ALSO 


cmd16(7), cmd807), lark8(7), sa800f£121(7);sa800f122(7), vm21(7), vm22(7). 


LARK25(7) LARK 25(7) 


NA ME 


lark25 — SOMb LARK Module Drive for VM21 Driver and VM22 Driver 


DESCRIPTION 


The files dsk/cntrir_OsO ... dsk/cntrlr_Os7 refer to sections of the LARK25 disk drive 0. 
The files dsk/cntrir_1s0O ... dsk/cntrir_1s7 refer to section of drive 1. This slicing allows 
the pack to be broken up into more manageable pieces. This new slicing also allows space on 
the disk for replacement tracks to be used by the software bad track replacement scheme. 


The origin and size of the sections on each drive are as follows: 


section start length 


0 15 38144 
1 90 33344 
2 165 28544 
3 240 23744 
4 315 18944 
5 390 =14144 
6 465 9344 
7 O 39936 


The start address is a cylinder address. The length is expressed in blocks, with each block con- 
taining 512 bytes. Since there is overlap, it is unwise for all of these files to be present in one 
installation. Information about recommended file system partitioning is provided in the 
“Administrative Guidelines” section of the SYSTEM V/68 Administrator's Guide. 


The dsk/* files access the disk via the system’s normal buffering mechanism and may be read 
and written without regard to physical disk records. There is also a “raw” interface which 
provides for direct transmission between the disk and the user’s read or write buffer. A sin- 
gle read or write call results in exactly one I/O operation and therefore raw I/O is consider- 
ably more efficient when many words are transmitted. The names of the raw files begin 
with rdsk and end with a number that selects the same disk section as the corresponding dsk 
file. 


In raw I/O, the buffer must begin on a word boundary, and counts must be a multiple of 512 


bytes (a disk block). Lseek(2) calls should specify a multiple of 512 bytes. 


FILES 


/dev/dsk/s, /dev/rdsk/* 


SEE ALSO 


cmd16(7), cmd80(7), lark 8(7), sa800f121(7), sa800f122(7), vm21(7), vm22(7). 


LP(7) | LP(7) 


NA ME 7 
lp — MVME410 line printer interface 


DESCRIPTION 
Lp provides the interface to any of the standard Printronix-type line printers or to any of the 
standard Centronics line printers. When opened or closed, a suitable number of page ejects are 
generated. Bytes written are printed. 


An internal parameter within the driver determines whether or not the device is treated as 
having a 96- or 64-character set. In half-ASCII mode, lowercase letters are turned into upper- 
case letters and certain characters are escaped according to the following table: 


{ 5 oi 
> 


| 4 


~w aA 


The driver correctly interprets carriage returns, backspaces, tabs, and form-feeds. A new-line 
that extends over the end of a page is turned into a form-feed. The default line length is 132 
characters, indent is 4 characters and lines per page is 66. Lines longer than the line length 
minus the indent (ie., 128 characters, using the above def aults) are truncated. 

Two ioctl(2) system calls are available: 


#include <sys/lprio.h> 
ioctl (fildes, command, arg) 
struct Iprio *arg; 


The commands are: 
LPRGET 


Get the current indent, columns per line, and lines per page and store in the 
lprio structure referenced by arg. 


LPRSET Set the current indent, columns per line, and lines per page from the struc- 
ture referenced by arg. 
Thus, indent, page width, and page length can be set with an external program. 
FILES 
/dev/\p* 


SEE ALSO 
Ip(1), ioct1(2). 


LP050(7) LP050(7) 


NAME 
1Ip050 — MVMEO050 line printer interface 


DESCRIPTION 
SYSTEM V/68 supports the parallel port on the MYME050 System Controller Module as the 
printer port. Lp050 provides the interface to any of the standard Printronix-type parallel line 
printers or the standard Centronics-type parallel line printers. When the device is opened or 


closed, a suitable number of page ejects are generated. Bytes written are printed using a 
buffered interface. 


The driver supports the printable ASCII character set (96 characters) and correctly interprets 
carriage returns, backspaces, tabs, and form-feeds. The defaults for line length, indent, and 
lines per page are 132, 4, and 66, respectively. Lines longer than the line length minus the 
indent (i.e., 128 characters, using the above defaults) are truncated. These defaults can be 
accessed and modified with an external program using the following calls. 


The two ioctl(2) system calls available are of the following form: 


#include <sys/Iprio.h> 
ioctl(fildes, command, arg) 
struct Iprio *arg; 

The commands are: 


LPRGET Get the current indent, columns per line, and lines per page and store in the 
Iprio structure referenced by arg. 


LPRSET Set the current indent, columns per line, and lines per page from the struc- 
ture referenced by arg. 


This driver does not support unbuffered parallel-to-serial-port conversion utilizing the paral- 
lel port on the MVME050 module. 
FILES 
/dev/Ip* 
SEE ALSO 
Ip(1), ioctl(2), mvme050(7), m050(7). 
MV ME050 System Controller Module and MYME701 I/O Transition Module User’s Manual. 


LRK25(7) 


NAME 


DESCRI 


FILES 


Irk25 — 25Mb LARK Module Drive for Universal Disk Driver 


PTION 


LRK25(7) 


The files dsk/cntrir_OsO ... dsk/cntrir_Os7 refer to sections of the LRK25 disk drive 0. The 
files dsk/cntrir_1s0 ... dsk/cntrir_1s7 refer to sections of drive 1. This slicing allows the 


pack to be broken up into more manageable pieces. 


‘The origin and size of the sections on each drive are as follows: 


section 


SNINNfWN KH © 


start 
0 
4992 
9984 
14976 
19968 
24960 
29952 
34944 


length 
39936 
34944 
29952 
24960 
19968 
14976 

9984 

4992 


The start address is a block address, with each block containing 512 bytes. Since there is over- 


lap, it is unwise for all of these files to be present in one installation. 


The dsk/* files access the disk via the system’s normal buffering mechanism and may be read 
and written without regard to physical disk records. There is also a “raw” interface which 
provides for direct transmission between the disk and the user’s read or write buffer. A sin- 
gle read or write call results in exactly one I/O operation and therefore raw I/O is consider- 
ably more efficient when many words are transmitted. The names of the raw files begin 
with rdsk and end with a number that selects the same disk section as the corresponding dsk 


file. 


In raw I/O the buffer must begin on a word boundary, and counts must be a multiple of 512 
bytes (a disk block). Likewise, lseek(2) calls should specify a multiple of 512 bytes. 


/dev/dsk/s, /dev/rdsk/* 


SEE ALSO 
ud(7), cm16(7), cm80(7), £18(7). 


MO050(7) M050(7) 


NAME 
m050 — MVME050 Serial Port 

DESCRIPTION 
Each MYME050 board supports two devices. Each line attached to an m050 behaves as 
described in termio(7). The line speed of each device can be changed under software control 
(output speed = input speed). The number of data bits (5, 6, 7, or 8), parity (even, odd, or 
no), and the number of stop bits (1 or 2) are also software selectable (refer to stty(1)). 

FILES 
/dev/mpcc0, /dev/mpccl 

SEE ALSO 
stty(1), termio(7). 


je 


M320(7) ; M320(7) 


NAME - 
m320 — general disk driver for the MVME320 
DESCRIPTION | 

The m320 driver provides support for Winchester Disks and 5 ¥4' IBM format floppy disks. 


Winchester support includes a provision for mapping bad tracks to alternates on the disk. The 
dinit(1M) program must be used to record bad track information for the use of the driver. 


The driver interprets the minor device number as follows: 


bit 7 bit 0 

oe oe oe or i oe 

0 0 

a ee ee ere an a a 
Se + 


Partition Number 


Unit N amabes 
pon---+ 
Controller Number 


(Zeros required) 
The controller number defines one of two MVME320 controllers, 0 or 1. 


The unit number defines one of four units on the controller. These assignments are fixed as 
follows: 


unit 0 Winchester Disk 
unit 1 Winchester Disk 
unit 2 5%4' IBM format floppy disk 
unit 3 5% IBM format floppy disk 


The partition number (also referred to as a “slice”) defines one of eight partitions (0 to 7). 
The m320 driver uses the same slicing defined for the wa(7) driver. 
Two ioctl(2) calls are available. 

int fildes; 

int command; 

union 


{ 
int blkno; 


struct 


int heads; 
int cylinders; 


volfmt; 


arg; 


ioctl (fildes, command, &arg); 
Fildes must be an opened file descriptor (as from open(2)) for a raw device. 


ah: 


M320(7) | M320(7) 


Command may be 1 or 2. When command is 1, a single track is formatted. Arg.blkno specifies 
a block in the track to be formatted relative to the origin of the slice opened as fildes. When 
command is 2, the entire volume is formatted. If the target disk is a Winchester, 
arg.volfmtheads and arg.volfmt.cylinders must be the number of heads and cylinders, respec- 
tively, on the target disk. This parameter is not required for a floppy disk, but &arg must be 
a valid user memory address. 


It is strongly recommended that dinit(1M) or m320fmt(1M) be used instead of direct calls to 
ioctl(2). 

NOTES 
A volume format request keeps the controller busy until the format completes. 


On IBM format 5 ¥4' floppy disks, track 0 contains 4 UNIX (512-byte) blocks (FM record- 
ing). Tracks 1 through 159 contain 8 blocks (MFM recording). 


FILES 
/dev/dsk/m320 _* 
/dev/rdsk/m320_* 
<sys/mvme320.h> 
<sys/io/m320i0.h> 
<sys/io/win.h> 
<sys/io/sa400.h> 
<sys/space/m320space.h> 


SEE ALSO , 
config(1M), master(4), dinit(1M), m320fmt(1M). 


M400(7) | M400(7) 


NAME . 
m400 — MVME400 Dual RS-232C Serial Port Module © 


DESCRIPTION 
Each MVME400 board supports two devices, with a maximum configuration of eight devices. 
(four boards). Each line attached to an m400 behaves as described in termio(7). The line 
speed of each device can be changed under software control (output speed = input speed). The 
number of data bits (5, 6, 7, or 8), parity (even, odd, or no) and the number of stop bits (1 or 
2) are also software selectable (refer to stty(1)). 


FILES 
/dev/console /dev/tty40* 


SEE ALSO 
stty(1), termio(7). 
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NAME 
m564 — serial ports on the MVMESYS131 

DESCRIPTION 
Each MVMESYS131 module supports two serial ports. The lines behave as described in ter- 
mio(7). The line speed of each device can be changed under software control (output speed 
= input speed). The number of data bits (5, 6, 7, or 8), parity (even, odd, or no), and the 
number of stop bits (1 or 2) are also software selectable (refer to stty(1)). 

FILES 
/dev/tty00, /dev/tty01 

SEE ALSO 
stty(1), termio(7). 
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NAME 
mem, kmem — core memory 


DESCRIPTION | 
Mem is a special file that is an image of the core memory of the computer. It may be used, 
for example, to examine and even to patch the system. | 


Byte addresses in mem are interpreted as memory addresses. References to non-existent loca- 
tions cause errors to be returned. 


Examining and patching device registers is likely to lead to unexpected results when read- 
only or write-only bits are present. | 


The file kmem is the same as mem except that kernel virtual memory rather than physical 
memory is accessed. | 


FILES 
/dev/mem, /dev/kmem 


BUGS | 
Mem does not access addresses outside of physical ram memory; hence, no device registers are 
available. 
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NAME 
mvme050 — driver for the MVME0S0 controller 
DESCRIPTION 
Mvyme050 provides initialization of and an interface to the MYME050 System Controller 


Module. Separate drivers and appropriate special devices exist for the system clock, two 
serial ports and parallel port which also exist on the MVME050 board. 


Reading one byte from this device returns the current state of the switch bank accessible 
from the front of the controller. Each bit represents the state of one of the eight switches 
(ON=1, OFF=0). 


Writing one byte to this device will cause the hex value of the byte to be displayed on the 
front panel display. Refer to the chapter “Operating Instructions” in the MVME050 System 
Controller Module and MVME701 I/O Transition Module User’s Manual for additional 
information. 

Two ioctl(2) system calls are available, which are of the form: 


#define DSPLY ON 0 
#define DSPLY_ OFF 1 
ioctl( fildes, command, arg) 


The argument arg is ignored. 

The commands are: 

DSPLY ON _ Turns on the display. 

DSPLY OFF Turns off the hex display. The default condition of the display is ON. 


FILES 
/dev/mvme050 


SEE ALSO | 
m050(7), 1p050(7), ioctl(2). 


ats 
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NAME 
mvme350 — MVME350 Streamer Tape Controller VMEmodule Interface 


DESCRIPTION 

The MVME350 driver controls one streaming tape drive per controller. It provides advanced 
read/write access and tape control. Though the user interface is similar to that of 9-track 
tapes, the QIC-02 Streaming Tape Interface prevents some forms of tape accesses. In partic- 
ular, streaming tapes may be completely rewritten (truncated) or files may be appended at 
the end-of-data. Unlike 9-track tapes, streaming tapes may not be overwritten in the middle 
of a tape file (terminated by a filemark). For this reason, the MVME350 driver only sup- 
ports two types of writing: truncating (the O_TRUNC open(2) option), and appending (the 
O_APPEND open(2) option). If O_-TRUNC and O_APPEND are both missing from an 
open(2) request, the MVME350 driver will supply the appropriate one depending upon the 
tape’s minor number. 


To support the “append” and “truncate” functions, two forms of MVME350 special files are 
defined: append devices and truncate devices. When an open(2) occurs with neither 
O_TRUNC nor O_APPEND present, then the file will be opened for truncation on the trun- 
cate device and for append on the append device. If the O_TRUNC or O_APPEND flags 
are present, it does not matter whether the truncate device or append device is used. 


CAUTION: the O_TRUNC and O_APPEND options to open(2) override the truncate and 
append special file designations. Therefore, if a program opens a truncate device with the 
O_APPEND option, then data will be appended. If a program opens a append device with 
the O_TRUNC option, then the tape will be rewritten. When using an unknown or untried 
program with the MVME350, first experiment by writing small amounts of information to 
determine whether the program uses the O_APPEND or O_TRUNC options, or neither. 
Some utilities may use both options in different situations; that is, some open(2) calls will use 
O_APPEND while others in the same program will use O_TRUNC, depending upon context. 
Most commonly used utilities are discussed below. 


Double Buffering. 

The MVME350 driver has been implemented with double buffering 1/O processing. When 
making an open(2) system call on a character (or raw) tape device, the MYME350 will nor- 
mally allocate two large system buffers to use during I/O. (See the section below regarding 
open(2) processing for exceptions.) These buffers will then be used for all direct, memory 
accesses (DMA) to and from the MVME350 Streaming Tape Controller. When making a 
read(2) system call, the data will first be read into one of the buffers, and then transferred to 
the reading program. When make a write(2) system call, the data will first be transferred 
from the writing program into one of the buffers. Only when the buffer is full will it be writ- 
ten to a streaming tape. 


The advantage of this double buffering scheme is that most MVME350 DMA transfers will be 
done very efficiently, thus keeping the tape “streaming” and wasting little or no space on the 
tape due to streaming tape underruns. The default buffer size of the double buffers is 128 
Kbytes for each buffer. 


When reading using the double buffers, the double buffering software will attempt to read 
ahead of the current read point. Therefore, when the first buffer is finally exhausted, it’s 
likely that the second buffer has already been filled. In this case, the new read(2) request 
may be completed immediately and a new read ahead may begin. The double buffering 
scheme will then stay ahead of the program that is reading the tape, and provide enough I/O 
overlap to permit efficient tape reading. 


When writing using the double buffers, the double buffering software will accept new 
write(2) requests until the current buffer is full. The software will then write out the full 
buffer and switch to the other buffer to accept more output. If the other buffer has not yet 
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been. completely written to tape, then the request will hold up the writing program until the 
I/O request is completed. 


The double buffering software may be permanently disabled, or the double buffering buffer 
sizes may be changed, using the m350ctl(1M) control program. 


Open(2) Processing. 
When the open(2) system call is made on an MVME350 streaming tape, the following process- 
ing will occur: 


1. If the minor device number is illegal, then the open(2) will fail, returning the error 
status ENXIO. 

2. If the tape unit is already open, then the open(2) will fail, returning the error status 
ENXIO. 

3. If the tape unit is not ‘on line”, and if an open(2) call is made without the 


O_NDELAY option, then the system call will fail, returning the error status ENXIO. 
If an I/O request is made prior to the device coming “on line”, then a device I/O 
error will occur. 


4. If the tape unit is being opened for writing and the tape is write-protected, then the 
open(2) will fail, returning the error status ENXIO. 

5. If the open(2) call is made with the O_.NDELAY option, then no DMA buffers will 
be allocated and all character I/O will occur unbuffered by the MVME350 driver. 

6. If the open(2) call is not made with the O_.NDELAY option, and if the driver is 


unable to allocate DMA buffers on a character device open, then the open(2) will fail, 
returning the error status ENXIO. 


7. When a tape is being opened for writing, it must be opened for rewrite or for Honan 
If the open request is made with the O_TRUNC flag (to truncate), the tape will be 
rewound and the tape will be rewritten. If the open request is made with the 
O_APPEND flag (to append), the tape will be positioned following the last data writ- 
ten onto the tape ( end-of-data). If the open request is not made with either 
O_TRUNC or O_APPEND, the device minor number will be used to determine 
which one to use. If the open request is made with both O_TRUNC and 
O_APPEND, O_TRUNC will override and the tape will be rewritten. 


Close(2) Processing. 
The following processing will occur upon a close(2) of a tape device: 


l. If the device was opened for writing, a filemark will be written onto the tape. 


2. If the special file indicated that the tape needs to be rewound, then the tape will be. 
rewound (“rewind on close’’). 


3. If the special file indicated that the tape is not to be rewound, and the device was 
opened for reading, then the tape will be positioned following the next filemark. 


When a character (raw) device is closed, the double buffers (if any) will normally be deallo- 
cated. The only exception to this rule occurs when an end-of-media is encountered while 
writing a streamer tape. This condition occurs when the program attempts to write off the 
end of a tape. The operator is notified of the condition by a message printed on the system 
console. The MVYME350 driver will then retain the double buffers and all data currently 
residing in them (which is not yet written to tape). If the same process then makes an 
open(2) request (for writing) on the same tape, then all remaining data in the double buffers 
will be written to tape prior to any new I/O requests. In this way, programs like cpio(1) may 
be used to write files that span more than one tape. If any other process opens the device © 
next, or if the device is not opened for writing, then the double buffers will be flushed (with 
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an error message printed on the system console). 


In all cases, the MVME350 driver will not complete close(2) processing until all streaming 
tape operations are done. Thus, the streaming tape should not be ejected before the program 
that is using the streaming tape is done. 


Ioctl(2) Processing 
The MVME350 driver supports several joct/(2) functions on the character or raw device. 
These functions permit control functions beyond the normal open(2), close(2), read(2), and 
write(2) system calls. The following functions are supported: 
M350REWIND 
rewinds the tape. 


M350ERASE 
erases and then rewinds the tape. 


M350RETENSION 
retensions the tape (needed whenever a tape has not been used for some time). 


M350WRTFM 


writes a filemark onto the tape. A filemark can only be written immediately after 
data has been written using the write(2) system call. 


M350RDFM 
reads the tape (and discards the data) up to and including the next filemark. 


M350SETDMA 
sets the character device DMA buffering size. The ioct/(2) argument parameter is the 


new buffer size. A buffer size of zero disables double buffering. Only the superuser 
may set the DMA buffer size. 


M350GETDMA 
returns the character device DMA (double) buffering size. The ioctl/(2) argument 
parameter is the address (in the user program) of the memory location to put the 
DMA buffering size. If double buffering is currently enabled, this function returns 
the size of the smallest of the two buffers. 


Human Interfaces. | 
The filenames used for the MVME350 incorporate the drive number, whether the device is a 


‘“rewind-on-close” device, and the DEFAULT write action. The general form for 
MVME350 file names is: 


/dev/{r}mt/m350_#[ta]{n} 
where: 


{r} is optional r 

# is the drive number 
[ta] isoneoftora 

{n} 1s optional n 


If the optional r is present, then the device is the raw (or character) -interface. If the t is 
present, and if the tape is opened for writing with neither O_TRUNC nor O_APPEND 
specified, then the tape will be opened with O_TRUNC. Similarly, if the a is present, and if 
the tape is opened for writing with neither O_TRUNC nor O_APPEND specified, then the 
tape will be opened with O_APPEND (called the append device). If the n is present, then 
the tape will not be rewound when the tape is closed. The filenames to use for the 
MVME350 block and character (raw) devices are: 


ee 
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BLOCK DEVICES 
_ REWIND ON CLOSE | ON CLOSE | NO REWIND ON CLOSE | CLOSE 


. /dev/mt/m350_Ct T /dev/mt/m350_Ctn_—| 
/dev/mt/m350_Ca /dev/mt/m350_Can 


lo TEER 
REWIND ON CLOSE | NO REWIND ON CLOSE 


where: C is the controller number to which the 
tape drive is attached. 


For example, to use the dd(1) command to copy a filesystem from disk 0s0 to the tape on the 
MVME350 controller zero, rewrite the tape, and to rewind the tape when done, execute: 


$ dd if=/dev/rdsk/0s0 of=/dev/rmt/m350_0t 


This command will perform a “raw” copy of the filesystem on disk 0s0 to the tape. The tape 
driver will prohibit accidental sharing of a tape drive by only permitting one open per drive 
at a time. 


Tape Usage. 
Due to the append or truncate restrictions on writing a tape, the normal tape compatible utili- 
ties need some special handling. If the tape is being accessed through I/O redirection in the 
Shell (sh(1)), then the append device should be used. If the tape is being opened by the util- 
ity, then the truncate device should normally be used. When writing new utilities to use the 
MVME350, explicit uses of O_TRUNC and O_APPEND in the open(2) should be made. 
The normal tape utilities need to be used in special ways: 


dd(1): The dd(1) program will always open the output file specified by the of= option, with 
the O_TRUNC flag. If no such option is specified, dd(1) will use its standard out- 
put. Therefore, to append to a tape using dd(1), redirect standard output using the 
Shell append redirection (>) with the append device; do not use the of= option. For 
example, to dump /dev/rdsk/0s0 onto the tape followed by /dev/rdsk/1s0, execute: 


$ dd if=/dev/rdsk/0s0 of=/dev/rmt/m350_0t 
$ dd if=/dev/rdsk/1s0 >/dev/rmt/m350_0a 


cpio(1): 
Since cpio(1) uses its standard output to write tapes, simply use the shell’s redirection 
with the append device. For example, to rewrite a tape using cpio(1): 
$ cpio -oBv < /filelist >/dev/rmt/m350 Ja 
To append to a tape using cpio(1): 


$ cpio -oBv < filelist >/dev/rmt/m350 Da 


tar(1): To specify the output tape, tar(1) requires the -f option on the command line. If the 
filename supplied via the -f option is -, then tar(1) will use its standard output. In 
this mode, tar(1) may be used in the same manner as cpio(1). For example, to rewrite 


ado 
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a tape using tar(1): 
$ tar -cf /dev/rmt/m350_0t files ... 
or 
$ tar -cf - files ... >/dev/rmt/m350_0t 
To append to a tape using tar(1): 
$ tar -cf /dev/rmt/m350 Da files ... 
or 


$ tar -cf - files ... >/dev/rmt/m350 Oa 


finc(1M): 
To write a tape using finc(1M), it is first necessary to label the tape by using 
labelit(1M).. For this purpose, it is better to use the truncate device. To label a tape 
and then write the tape using finc(1M), execute: 


$ labelit /dev/rmt/m350 _Ot fsname volname -n 
$ finc -m -10 /dev/rdsk/0s0 /dev/rmt/m350_0t 


The above example copies all files on the device /dev/rdsk/0sO that have been — 
modified in the last 10. days onto the streamer tape. 

frec(1M): 
Since frec(1M) does not write tapes, it does not matter whether the truncate device or 
append device is used. 


volcopy(1M): 
Like finc(1M), volcopy(1M) requires the tape to have a labelit(/1M) label at the begin- 
ning. For this purpose the truncate device is the best to use. To label a tape and then 
use volcopy(1M) to write it, execute: | 


$ labelit /dev/rmt/m350_0t fsname volname -n 
$ volcopy fsname /dev/rdsk/0s0 volname /dev/rmt/m350_0t volname 


The above example copies the filesystem on device /dev/rdsk/0s0 onto streamer tape. 


When reading tapes, either the append or truncate devices may be used. To begin reading 
from the second or subsequent file on a tape, the tape must be spaced to that file using the 
“no-rewind-on-close” device. For example, to space the tape to the second file on a tape, 
execute: | 


$ dd if=/dev/rmt/m350_0tn of=/dev/null 
When the dd(1) completes, the tape will be left at the beginning of the second file on the 


tape. If another read is attempted, it will read from the second file. If there is no second © 
file, the MVME350 will generate an error. | 


M350ctl(1M) Usage. 


The m350ctl(1M) utility is used to gain quick access to the MYME350 devices. See the 
m350ctl(1M) manual page for more details. The program supports the following functions: 
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rewind, retension, erase, tape positioning, and DMA buffer size get and set. 


Error Messages 
The MVME350 generates many different error messages. These error messages, printed in 
English, attempt to provide enough information to permit the operator to diagnose tape prob- 
lems. Most error messages start with a line that prints out the controller and drive number 
that has the error. The first line of the error message looks like: 


MVME3350: Error on controller 0, drive 0 


The second and subsequent lines of the error message describe the symptoms encountered: 


Filemark detected. 
The last operation encountered a filemark When encountered, a filemark will nor- 
mally terminate reading and return without an error status. 


Unrecoverable data error. 
Some form of unrecoverable error has occurred. The operation should be retried. If 
the operation continues to get this error, then the tape is probably damaged. 


End of Media. 


The tape has encountered the end-of-media indicator. Further reading or writing of © 
this tape is not allowed without rewinding. _ 


Write Protected. 
The tape’s write-protect switch is set to SAFE. Normally, the open(2) will fail when 
attempting to open a write-protected tape for write. 


Drive not online. | | 
The MVME350 does not detect an “on-line” status from the streamer tape drive. 
Check that all cables are properly attached. If so, then retry the operation. If the 
problem persists, then the streamer tape drive is probably damaged. 


Cartridge not in place. 
No streamer tape cartridge has been loaded into the selected tape drive. Check to be 
sure the proper special file has been used to access the tape. If this problem persists, 
then the streamer tape drive is probably damaged. 


Beginning of Media. 
The beginning-of-media has been encountered. The tape is now rewound correctly. 
No data detected. 


The MVME350 has not detected any data on the tape during a read operation. A 
read has probably been attempted past the end-of-media. 


No file mark encountered 


An attempt to find a filemark has failed. The desired filemark appears not to be on 
the tape. 


Not a beginning of tape. 
The tape is not at the beginning-of-tape as expected. 


Tape reset did not occur. 
After every reported error, the MVME350 attempts to reset the tape drive. If the 
reset fails, this error message will be printed. 


Timeout. 


Some internal timeout has occurred, aborting the operation. Try the operation again. 
If the problem persists, then try a new tape or tape drive. 
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Bad Unit. 
A tape drive unit failed to respond. Try the operation again. If the error persists, 
then the cables or tape drive are probably damaged. 
Bad Drive. 
A tape drive unit failed to respond. Try the operation again. If the error persists, 
then the cables or tape drive is probably damaged. 
If an error message has only the first line, then retry the operation. If the error persists, then 
the MVME350 controller, the MVME350 driver software, or the streaming tape drive may be 
damaged or confused. In persistent errors, resetting the machine or cycling power will some- 
times clear the problem. 


The MVME350 driver also produces some warning messages. These warning messages are 
not fatal errors but are important to the operator. The warning messages are: 
DMA buffers still active. | 
The last write onto the tape (using double buffering) encountered the end-of-media. 
The buffers are being retained for subsequent write operations (See the section on 
Double Buffering above). 
DMA buffers discarded. 
The new open(2) request is by a different program or is not requesting to write. The 
retained buffers are discarded (See the section on Double Buffering above). 
Initialization error. 
The MVME35S0 initialization sequence did not succeed. The hexadecimal value fol- 
lowing the error message should be reported to the system administrator. 
FILES | 
/dev/rmt/m350_* /usr/include/sys/mvme350.h 
SEE ALSO 


m350ctl(1M), cpio(1), dd(1), tar(1), finc(1M), frec(1M), volcopy(1M), open(2), close(2), 
i0ctl(2). 
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NAME 
null — the null file 


DESCRIPTION 
Data written on a null special file is discarded. 


Reads from a null special file always return O bytes. 


FILES 
/dev/null 
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NAME 
prf — operating system profiler 
DESCRIPTION 
The file pr f provides access to activity information in the operating system. Writing the file 


loads the measurement facility with text addresses to be monitored. Reading the file returns 
these addresses and a set of counters indicative of activity between adjacent text addresses. 


The recording mechanism is driven by the system clock and samples the program counter at 
line frequency. Samples that catch the operating system are matched against the stored text 
addresses and increment corresponding counters for later processing. 


The file pr f is a pseudo-device with no associated hardware. 


FILES 
/dev/prf 


SEE ALSO 
config.68(1M), profiler(1M). 
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NA ME 


sa400f122 — 54-inch Floppy Disk Drive for VM22 Driver 


DESCRIPTION 


FILES 


Although it is possible to have eight devices for each floppy disk drive, only five devices per 
floppy disk drive are currently defined: dsk/vm22_xsO, dsk/vm22_xs1, dsk/vm22_xs2, 
dsk/vm22_xs3, and dsk/vym22_xs7. 


Dsk/vm22_xs1 and dsk/vm22_xs3 are defined for single-sided drives or single-sided disks in 
double-sided drives. Dsk/vm22_xs0 and dsk/vym22_xs2 are defined for double-sided disks 
in double-sided drives. Dsk/vm22_xs7 is defined to cover the entire contents of the largest 
supported disk. These slices are created to be compatible with the slicing definition needed by 
the hard disk when using the software bad track replacement scheme. 


The origin and size of the sections on each drive are as follows: 


section start length description 
0 1 632 double-sided, single density 
1 1 316 single-sided, single density 
2 1 1264 double-sided, double density 
3 1 632 single-sided, double density 
4 = 2 
5 = : 
6 is 


7 0) 1276 _—largest floppy size 


The start address is a cylinder address. The length is expressed in blocks, with each block con- 
taining 512 bytes. Information about recommended file system partitioning is provided in the 
“Administrative Guidelines” section of the SYSTEM V/68 Administrator's Guide. 


The dsk/* files access the disk via the system’s normal buffering mechanism and may be read 
and written without regard to physical disk records. There is also a “raw” interface which 
provides for direct transmission between the disk and the user’s read or write buffer. A sin- 
gle read or write call results in exactly one I/O operation and therefore raw I/O 1s consider- 
ably more efficient when many words are transmitted. The names of the raw files begin 
with rdsk and end with a number which selects the same disk section as the corresponding 
dsk file. | 


In raw I/O, the buffer must begin on a word boundary, and counts must be a multiple of 512 
bytes (a disk block). Lseek(2) calls should specify a multiple of 512 bytes. 


/dev/dsk/*, /dev/rdsk/* 


SEE ALSO 


cmd16(7), cmd80(7), lark25(7), lark8(7), sa800f£122, vm22(7). 
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NAME 


sa400flwd — 5 %inch Floppy Disk Drive for the Winchester Disk Driver and the general disk 
driver for the MVME319 and MVME320 Disk Controllers 


DESCRIPTION 


Although it is possible to have eight devices for each floppy disk drive, only two devices per 
floppy disk drive are currently defined: dsk/[cntrir_]xs0 and dsk/[cntrir_]xs7. 


Dsk/[cntrir_]xs0 and dsk/[cntrir_]xs7 are defined for double-sided disks in double-sided 
drives. These slices are created to be compatible with a double-sided, double density floppy 
created on a VME/10. A floppy created in wd_0s0 on a RWINI (VME/10) can be read 
directly in [cntrir_}]xs0 on a M320 or ID. 


The origin and size of the sections on each drive are as follows: 


section Start length description 
12 1264 double-sided double density 


“YAH BR WN — © 
t 
‘ 


0 1276 Largest floppy size 


The start address is a block address. The length 1s expressed in blocks, with each block con- 
taining 512 bytes. Information about recommended file system partitioning is provided in the 
‘“‘Administrative Guidelines” section of the 

Administrator’s Guide. 


The dsk/* files access the disk via the system’s normal buffering mechanism and may be read 
and written without regard to physical disk records. There is also a “raw” interface which 
provides for direct transmission between the disk and the user’s read and write buffer. A 
single read or write call results in exactly one I/O operation and therefore raw I/O is consid- 
erably more efficient when many words are transmitted. The names of the raw files begin 


with rdsk and end with a number which selects the same disk section as the corresponding 


FILES 


dsk file. 


In raw I/O, the buffer must begin on a word boundary and counts must be a multiple of 512 
bytes (a disk block). Lseek(2) calls should specify a multiple of 512 bytes. 


/dev/dsk/*, /dev/rdsk/* 


SEE ALSO 


1d(7), m320(7), wd15(7), wd40(7). 


Sis 
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NA ME | 
sa800f121 — 8-inch Floppy Disk Drive for VM21 Driver 


DESCRIPTION 
Although it is possible to have eight devices for each floppy disk drive, only four devices per 
floppy disk drive are currently defined: dsk/vm21_xs0, dsk/vm21_xs1, dsk/vm21_xs6, and 
dsk/vm21_xs7. | 


Dsk/vm21_xsO and dsk/vm21_xs6 are defined for single-sided drives or single-sided disks in 
double-sided drives. Dsk/vm21_xs1 and dsk/vm21_xs7 are defined for double-sided disks in 
double-sided drives. These slices are created to be compatible with the slicing definition 
needed by the hard disk when using the software bad track replacement scheme. 


The origin and size of the sections on each drive are as follows: 


section start length description 
0 1 988 double-sided, single density 
1 2 487 _ single-sided, single density 
2 af : 
3 r : 
4 : = 
5 : : 
6 0 500 
7 0 1000 | 


The start address is a cylinder address. The length is expressed in blocks, with each block con- 
taining 512 bytes. Information about recommended file system partitioning is provided in the 
“Administrative Guidelines” section of the SYSTEM V/68 Administrator's Guide. 


The dsk/* files access the disk via the system’s normal buffering mechanism and may be read 
and written without regard to physical disk records. There is also a “raw” interface which 
provides for direct transmission between the disk and the user’s read or write buffer. A sin- 
gle read or write call results in exactly one I/O operation and therefore raw I/O is consider- 
ably more efficient when many words are transmitted. The names of the raw files begin 
with rdsk and end with a number which selects the same disk section as the corresponding 
dsk file. 


In raw I/O, the buffer must begin on a word boundary, and counts must be a multiple of 512 
bytes (a disk block). Lseek(2) calls should specify a multiple of 512 bytes. 


FILES 
/dev/dsk/*, /dev/rdsk/* 


SEE ALSO 
cmd16(7), cmd80(7), lark25(7), lark 8(7), vm21(7). 
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NA ME 
sa800f122 — 8-inch Floppy Disk Drive for VM22 Driver 


DESCRIPTION 
Although it is possible to have eight devices for each floppy disk drive, only five devices per 
floppy disk drive are currently defined: dsk/vm22_xs0, dsk/vm22_xs1, dsk/vm22_<xs2, 
dsk/vm22_xs3, and dsk/vm22_xs7. 


Dsk/vm22_xs1 and dsk/vm22_xs3 are defined for single-sided drives or single-sided disks in 
double-sided drives. Dsk/vm22_xs0 and dsk/vm22_xs2 are defined for double-sided disks 
in double-sided drives. Dsk/vm22_xs7 is defined to cover the entire contents of the largest 
supported disk. These slices are created to be compatible with the slicing definition needed by 
the hard disk when using the software bad track replacement scheme. 


The origin and size of the sections on each drive are as follows: 


section start length _ description 
0 1 988 double-sided, single density 
2 487 single-sided, single density 
1 1976 double-sided, double density 
2 975 single-sided, double density 


0 2002 largest floppy size 


“A A & W WH ro 
{ 


The start address is a cylinder address. The length is expressed in blocks, with each block con- 
taining 512 bytes. Information about recommended file system partitioning is provided in the 
“Administrative Guidelines” section of the SYSTEM V/68 Administrator’s Guide. 


The dsk/* files access the disk via the system’s normal buffering mechanism and may be read 
and written without regard to physical disk records. There is also a “raw” interface which 
provides for direct transmission between the disk and the user’s read or write buffer. A sin- 
gle read or write call results in exactly one I/O operation and therefore raw I/O is consider- 
ably more efficient when many words are transmitted. The names of the raw files begin 
with rdsk and end with a number which selects the same disk section as the corresponding 
dsk file. 


In raw I/O, the buffer must begin on a word boundary, and counts must be a multiple of 512 
bytes (a disk block). Lseek(2) calls should specify a multiple of 512 bytes. 


FILES 
/dev/dsk/*, /dev/rdsk/* 


SEE ALSO 
cmd16(7), cmd80(7), lark25(7), lark 8(7), sa400f122(7), vm22(7). 
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NAME 
sxt — pseudo-device driver 

DESCRIPTION | 
Sxt is a pseudo-device driver that interposes a discipline between the standard ¢ty line discip- 
lines and a real device driver. The standard disciplines manipulate virtual tty structures. 
(channels) declared by the sxt driver. Sxt acts as a discipline manipulating a real tty struc- 
ture declared as a real device driver. The sxt driver is currently only used by the shi(1) 
command. 


Virtual ttys are named by inodes in the subdirectory /dev/sxt and are allocated in groups of 
up to eight. To allocate a group, a program should exclusively open a file with a name of the 
form /dev/sxt/??0 (channel 0) and then execute a SXTIOCLINK ioctl(2) call to initiate the 
multiplexing. 

Only one channel, the “controlling” channel, can receive input from the Keyboard at a time; 
others attempting to read will be blocked. 


There are two groups of ioct/(2) commands supported by sxt. The first group contains the 
standard ioctl commands described in termi 7), with the addition of the following: 


TIOCEXCL Set exclusive use mode: no further opens are permitted until the file has 
been closed. 


TIOCNXCL Reset exclusive use mode: further opens are once again permitted. 


The second group are directives to sxt itself. Some of these may only be executed on channel 
0. 


SX TIOCLINK Allocate a channel group and multiplex the virtual ttys onto the 
real tty. The argument is the number of channels to allocate. 
This command may only be executed on channel 0. Possible 
errors include: 


EINVAL The argument is out of range. 
ENOTTY The command was not issued from a real tty. 
ENXIO  linesw is not configured with sxt. 


EBUSY An SXTIOCLINK command has already been issued for 
this real tty. | 


ENOMEM 
There is no system memory available for allocating the 
virtual tty structures. 


EBADF Channel 0 -was not opened before this call. 

SX TIOCS WTCH Set the controlling channel. Possible errors include: 
EINVAL An invalid channel number was given. 
EPERM The command was not executed from channel 0. 


SX TIOCWF Cause a channel to wait until it is the controlling channel. This 
command will return the error, EINVAL, if an invalid channel 
number is given. 


SX TIOCU BLK Turn off the loblk control flag in the virtual tty of the indicated 
channel. The error EINVAL will be returned if an invalid 
number or channel 0 is given. 


SX TIOCSTAT yet the status (blocked on input or output) of each channel and 
store in the sxtblock structure referenced by the argument. The 
error EFAULT will be returned if the structure cannot be 
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written. 


SX TIOCTRACE Enable tracing. Tracing information is written to /dev/osm on 
the 3B 20 computer or to the console on the VAX. This command 
has no effect if tracing is not configured. 


SXTIOCNOTRACE Disable tracing. This command has no effect if tracing is not con- — 


figured. 
FILES 7 
/dev/sxt/?2[0-7] Virtual tty devices 
/usr/include/sys/sxt.h Driver specific definitions. 
SEE ALSO 


shl(1), stty(1), ioctl(2), open(2), termio(7). 
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NA ME 
. termio — general terminal interface 
DESCRIPTION 


All of the asynchronous communications ports use the same general interface, no matter what 
hardware is involved. Common features of this interface are presented in this section. 


When a terminal file is opened, it normally causes the process to wait until a connection is 
established. In practice, users’ programs seldom open these files; they are opened by getty and 
become a user’s standard input, output, and error files. The first terminal file opened by the 
process group leader of a terminal file not already associated with a process group becomes the 
control terminal for that process group. The control terminal plays a special role in handling 
quit and interrupt signals, as discussed below. The control terminal is inherited by a child 
process during a fork(2). A process can break this association by changing its process group 
using set pgrp(2). 7 


A terminal associated with one of these files ordinarily operates in full-duplex mode. Charac- 
ters may be typed at any time, and are only lost when the system’s character input buffers 
become completely full, or when the user has accumulated the maximum allowed number of 
input characters that have not yet been read by some program. Currently, this limit is 256 
characters. When the input limit is reached, all the saved characters are discarded without 
notice. 


Normally, terminal input is processed in units of lines. A line is delimited by a newline 
(ASCII LF) character, an end-of-file (ASCII EOT) character, or an end-of-line character. This 
means that a program attempting to read is suspended until an entire line has been typed. 
Also, no matter how many characters are requested in the read call, one line at most is 
returned. It is not necessary, however, to read a whole line at once; any number of characters 
may be requested in a read, even one, without losing information. 


During input, erase and kill processing is normally done. By default, the character # erases 
the last character typed, except that it does not erase beyond the beginning of the line. By 
default, the character @ kills (deletes) the entire input line, and optionally outputs a newline 
character. Both these characters operate on a key-stroke basis, independently of any backspac- 
ing or tabbing that may have been done. Both the erase and kill characters may be entered 
literally by preceding them with the escape character (\). In this case, the escape character is 
not read. The erase and kill characters may be changed. 


Certain characters have special functions on input. These functions and their default charac- 
ter values are summarized as follows: | 


INTR (Rubout or ASCII DEL) generates an interrupt signal which is sent to all processes 
with the associated control terminal. Normally, each such process is forced to ter- 
minate, but arrangements may be made either to ignore the signal or to receive a 
trap to an agreed-upon location; see signal (2). 


QUIT (Control-| or ASCII FS) generates a quit signal. Its treatment is identical to the inter- 
rupt signal except that, unless a receiving process has made other arrangements, it is 
not only terminated but a core image file (called core) is created in the current 
working directory. | 


SWTCH ASCII NUL is used by the job control facility, shi(1), to change the current layer to 
the control layer. 


ERASE (#) erases the preceding character. It does not erase beyond the start of a line, as del- 
| ‘Imited by a NL, EOF, or HOL character. 


KILL (@) deletes the entire line, as delimited by a NL, BOF, or EOL character. 


EOF (Control-d or ASCII BOT) may be used to generate an end-of-file from a terminal. 
When received, all the characters waiting to be read are immediately passed to the 
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program, without waiting for a newline, and the EOF is discarded. Thus, if there are 
no characters waiting, i.e., the EOF occurred at the beginning of a line, zero charac- 
ters are passed back, which is the standard end-of-file indication. 


NL (ASCII LF) is the normal line delimiter. It can not be changed or escaped. 
EOL (ASCII NUL) is an additional line delimiter, similar to NL. Normally, it is not used. 


STOP —_(Control-s or ASCII DC3) can be used to temporarily suspend output. It is useful 
with CRT terminals to prevent output from disappearing before it can be read. 
While output is suspended, STOP characters are ignored and not read. 


START (Control-q or ASCII DC1) is used to resume output that has been suspended by a STOP 
character. While output is not suspended, START characters are ignored and not 
read. The start/stop characters can not be changed or escaped. 


The character values for INTR, QUIT, SWTCH, ERASE, KILL, EOF, and EOL may be changed to 
suit individual tastes. The ERASE, KILL, and EOF characters may be escaped by a preceding \ 
character, in which case no special function is done. 


When the carrier signal from the data-set drops, a hangup signal is sent to all processes that 
have this terminal as the control terminal. Unless other arrangements have been made, this 
signal causes the processes to terminate. If the hangup signal is ignored, any subsequent read 
returns with an end-of-file indication. Thus, programs that read a terminal and test for end- 
of-file can terminate appropriately when hung up on. 


When one or more characters are written, they are transmitted to the terminal as soon as 
previously-written characters have finished printing. Input characters are echoed by putting 
them in the output queue as they arrive. If a process produces characters more rapidly than 
they are printed, it is suspended when its output queue exceeds some limit. When the queue 
has drained to some threshold, the program is resumed. 


Several ioctl(2) system calls apply to terminal files. The primary calls use the following 
structure, defined in <termio.h>: 


#define NCC 8 

struct termio { | 
unsigned short  c_iflag; /* input modes *#/ 
unsigned short  c_oflag; /* output modes #/ 
unsigned short c_cflag; /* control modes */ 
unsigned short c_Iflag; /* local modes */ 
char c_line; /* line discipline */ 


unsigned char c_cc[NCCk /*control chars */ 
}; 
CONTROL CHARACTERS 
The special control characters are defined by the,array c_cc. The relative positions and initial 
values for each function are as follows: | 
Q  VINTR DEL 


1  VQUIT FS 
2 VERASE # 

3. VKILL @ 
4 VEOF EOT 
5S  VEOL NUL 
6 reserved | 

7 VSWTCH NUL 


Refer to the section “LOCAL MODES” for information about enabling and disabling the func- 
tions of these characters. As stated in that section and shown in termio.h, if canonical pro- 
cessing is not set, positions 4 and 5 contain values for VMIN and VTIME, respectively. 
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INPUT MODES © 
The c_iflag field describes the basic terminal input control: 


IGNBRK OO00001 Ignore break condition. 

BRKINT QOO0002 Signal interrupt on break. 

IGNPAR 0000004 Ignore characters with parity errors. 
PARMRK 0000010 Mark parity errors. 

INPCK O000020 Enable input parity check. 

ISTRIP Q000040 Strip character. 

INLCR 0000100 Map NL to CR on input. 

IGNCR OO000200 Ignore CR. | 

ICRNL 0000400 Map CR to NL on input. 

IUCLC 0001000 Map uppercase to lowercase on input. 
IXON 0002000 Enable start/stop output control. 
IXANY 0004000 Enable any character to restart output. 
IXOFF 0010000 Enable start/stop input control. 


If IGNBRK is set, the break condition (a character framing error with data all zeros) is ignored, 
that is, not put on the input queue and, therefore, not read by any process. Otherwise, if 
BRKINT is set, the break condition generates an interrupt signal and flushes both the input and 
output queues. If IGNPAR is set, characters with other framing and parity errors are ignored. 


If PARMRK is set, a character with a framing or parity error which is not ignored is read as 
the three-character sequence: 0377, 0, X, where X is the data of the character received in 
error. To avoid ambiguity in this case, if ISTRIP is not set, a valid character of 0377 is read as 
0377, 0377. If PARMRK is not set, a framing or parity error which is not ignored is read as the 
character NUL (0). 


If INPCK is set, input parity checking is enabled. If INPCK is not set, input parity checking is 
disabled. This allows output parity generation without input parity errors. 


If ISTRIP is set, valid input characters are first stripped to 7 bits; otherwise, all 8 bits are pro- 
cessed. | | 


If INLCR is set, a received NL character is translated into a CR character. If IGNCR is set, a 
received CR character is ignored (not read). Otherwise, if ICRNL is set, a received CR character 
is translated into a NL character. 


If IUCLC is set, a received uppercase alphabetic character is translated into the corresponding 
lowercase character. 


If IXON is set, start/stop output control is enabled. A received STOP character suspends output, 
and a received START character restarts output. All start/stop characters are ignored and not 
read. If IXANY is set, any input character restarts output that has been suspended. | 


If IXOFF is set, the system transmits START/STOP characters when the input queue is nearly 
empty/full. 


The initial input control value is all bits clear. 


OUTPUT MODES 
The c_oflag field specifies the system treatment of output: 


OPOST 0000001 Postprocess output. 

OLCUC OO000002 Map lowercase to uppercase on output. 
ONLCR OOO0004 Map NL to CR-NL on output. 

OCRNL 0000010 Map CR to NL on output. 

ONOCR 0000020 No CR output at column 0. 

ONLRET 0000040 NL performs CR function. 

OFILL 0000100 Use fill characters for delay. 

OFDEL 0000200 Fill is DEL, else NUL. 
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NLDLY 0000400 Select newline delays: 
NLO 0 

NL1 0000400 

CRDLY 0003000 Select carriage-return delays: 
CRO 0 

CR1 0001000 

CR2 0002000 

CR3 0003000 

TABDLY 0014000 Select horizontal-tab delays: 
TABO O 

TABI 0004000 

TAB2 0010000 

TAB3 0014000 Expand tabs to spaces. 
BSDLY 0020000 Select backspace delays: 
BSO 0 

BS1 0020000 

VTDLY 0040000 Select vertical-tab delays: 
VTO O 

VTl 0040000 

FFDL Y 0100000 Select form-feed delays: 
FFO O 

FF1 0100000 
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If OPOST is set, output characters are post-processed as indicated by the remaining flags; other- 
wise, Characters are transmitted without change. 


If OLCUC is set, a lowercase alphabetic character is transmitted as the corresponding uppercase 
character. This function is often used in conjunction with IUCLC. 


If ONLCR is set, the NL character is transmitted as the CR-NL character pair. If OCRNL is set, 
the CR character is transmitted as the NL character. If ONOCR is set, no CR character is 
transmitted when at column 0 (first position). If ONLRET is set, the NL character is assumed 
to do the carriage-return function; the column pointer is set to O and the delays specified for 
CR are used. Otherwise, the NL character is assumed to do just the line-feed function; the 
column pointer remains unchanged. The column pointer is also set to 0 if the CR character is 
actually transmitted. 


The delay bits specify how long transmission stops to allow for mechanical or other move- 
ment when certain characters are sent to the terminal. In all cases, a value of O indicates no 
delay. If OFILL is set, fill characters are transmitted for delay instead of a timed delay. This 
is useful for high baud rate terminals which need only a minimal delay. If OFDEL is set, the 
fill character is DEL; otherwise, it is NUL. 


If a form-feed or vertical-tab delay is specified, it lasts for about 2 seconds. 


Newline delay lasts about 0.10 seconds. If ONLRET is set, the carriage-return delays are used 
instead of the newline delays. If OFILL is set, two fill characters are transmitted. 


Carriage-return delay type 1 is dependent on the current column position, type 2 is about 0.10 
seconds, and type 3 is about 0.15 seconds. If OFILL is set, delay type 1 transmits two fill char- 
acters and type 2 transmits four fill characters. 


Horizontal-tab delay type 1 is dependent on the current column position. Type 2 is about 0.10 
seconds. Type 3 specifies that tabs are to be expanded into spaces. If OFILL is set, two fill 
characters are transmitted for any delay. | 


Backspace delay lasts about 0.05 seconds. If OFILL is set, one fill character is transmitted. 
The actual delays depend on line speed and system load. 
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The initial output control value is all bits clear. 


CONTROL MODES 


The c_c flag field describes the hardware control of the terminal: 


CBAUD 0000017 Baud rate: 
BO O Hang up 
BSO 0000001 50 baud 
B75 OO000002 75 baud 
B110 0000003 110 baud 
B134 0000004 134.5 baud 
B150 OOOOO00OS 150 baud 
B200 0000006 200 baud 
B300 0000007 300 baud 
B600 0000010 600 baud 
B1i200 0000011 1200 baud 
B1800 0000012 1800 baud 
B2400 0000013 2400 baud 
B4800 0000014 4800 baud 
B9600 0000015 9600 baud 
EXTA 0000016 External A 
EXTB 0000017 External B 
CSIZE 0000060 Character size: 
CSS 0) 5 bits 

CS6 0000020 6 bits 

CS7 0000040 7 bits 

CS8 0000060 8 bits 


CSTOPB 0000100 
CREAD —_ 0000200 
~ PARENB 0000400 
PARODD 0001000 
HU PCL 0002000 
CLOCAL 0004000 


Send two stop bits, else one. 
Enable receiver. 

Parity enable. 

Odd parity, else even. 

Hang up on last close. 
Local line, else dial-up. 
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The CBAUD bits specify the baud rate. The zero baud rate, BO, is used to hang up the connec- 
tion. If BO is specified, the data-terminal-ready signal is not asserted. Normally, this discon- 
nects the line. For any particular hardware, impossible speed changes are ignored. 


The CSIZE bits specify the character size in bits for both transmission and reception. This size 
does not include the parity bit, if any. If CSTOPB is set, two stop bits are used; otherwise, one 
stop bit is used. For example, at 110 baud, two stops bits are required. 


If PARENB is Set, parity generation and detection is enabled, and a parity bit is added to each 
character. If parity is enabled, the PARODD flag specifies odd parity if set; otherwise, even 
parity is used. 

If CREAD is set, the receiver 1s enabled; otherwise, no characters are received. 

If HUPCL is set, the line is disconnected when the last process with the line open closes it or 
terminates, i.e., the data-terminal-ready signal is not asserted. 


If CLOCAL 1s set, the line is assumed to be a local, direct connection with no modem control. 
If it is not set, modem control is assumed. 


The initial hardware control value after open is B300, CS8, CREAD, HUPCL. 


LOCAL MODES | 
The c_lflag field of the argument structure is used by the line discipline to control terminal 
functions. The basic line discipline (0) provides the following: 


TERMIO(7) 


TERMIO(7) 


ISIG 0000001 Enable signals. 

ICANON 0000002 Canonical input (erase and kill processing). 
XCASE 0000004 Canonical upper/lower presentation. 
ECHO 0000010 Enable echo. 

ECHOE OOOO020 Echo erase character as BS-SP-BS. 

ECH OK OOO0040 Echo NL after kill character. 

ECH ONL QO00100 Echo NL. 

NOFLSH OOO0200 Disable flush after interrupt or quit. 


If ISIG is set, each input character is checked against the special control characters INTR and 
QUIT. If an input character matches one of these control characters, the function associated 
with that character is performed. If ISIG is not set, no checking is done. Thus, these special 
input functions are possible only if ISIG is set. These functions may be disabled individually 
by changing the value of the control character to an unlikely or impossible value (e.g., 0377). 


If ICANON is set, canonical processing is enabled. This enables the erase and kill edit func- 
tions, and the assembly of input characters into lines delimited by NL, EOF, and EOL. If 
ICANON is not set, read requests are satisfied directly from the input queue. A read is not 
satisfied until at least VMIN characters have been received or the timeout value VTIME has 
expired. This allows fast bursts of input to be read efficiently while still allowing single 
character input. The VMIN and VTIME values are stored in the positions for the EOF and EOL 
characters, respectively. The VTIME value represents tenths of seconds. 


If XCASE is set, and if ICA NON is set, an uppercase letter is accepted on input by preceding it 
with a \ character, and is output preceded by a \ character. In this mode, the following escape 
sequences are generated on output and accepted on input: 


for: use: 
; \' 

\! 
| 
{ \( 
} \) 
\ \\ 


For example, A is input as \a, \n as \\n, and \N as \\\n. 
If ECHO is set, characters are echoed as received. 


When ICANON is set, the following echo functions are possible. If BCHO and ECHOE are set, 
the erase character is echoed as ASCII BS SP BS, which clears the last character from a CRT 
screen. If ECHOE is set and ECHO is not set, the erase character is echoed as ASCII SP BS. If 
FCHOK is set, the NL character is echoed after the kill character to emphasize that the line is 
deleted. Note that an escape character preceding the erase or kill character removes any spe- 
cial function. If ECHONL is set, the NL character is echoed even if ECHO is not set. This is 
useful for terminals set to local echo (so-called half duplex). Unless escaped, the EOF charac- 
ter is not echoed. Because KOT is the default EOF character, this prevents terminals that 
respond to KOT from hanging up. 


If NOFLSH is set, the normal flush of the input and output queues associated with the quit 
and interrupt characters is not done. 


The initial line-discipline control value is all bits clear. 


I/O SYSTEM CALLS 


The primary ioctl(2) system calls have the form: 


ioctl ( fildes, command, arg) 
struct termio tary; 
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The commands using this form are: 


TCGETA 


TCSETA 


TCSETAW 


TCSETAF 


Get the parameters soe ateel with the terminal and store in the termio 
structure referenced by arg. 


Set the parameters associated with the terminal from the structure refer- 
enced by arg. The change is immediate. 


Wait for the output to drain before setting new parameters. This form 
should be used when changing parameters that affect output. 


Wait for the output to drain, then flush the input queue and set the 
new parameters. 


Additional ioctl(2) calls have the form: 


ioctl (fildes, command, arg) 


int arg; 


The commands using this form are: 


TCSBRK 
TCX ONC 
TCFLSH 
FILES 
/dev/tty* 
SEE ALSO 


Wait for the output to drain. If arg is 0, then send a break (zero bits for 
0.25 seconds). 


Start/stop control. If arg is 0, suspend output; if 1, restart suspended 
output. | 


If arg is 0, flush the input queue; if 1, flush the output queue; if 2, 
flush both the input and output queues. 


stty(1), fork(2), ioctl(2), setpgrp(2), signal(2). 
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NAME 
tty — controlling terminal interface 


DESCRIPTION 
The file /dev/tty is a synonym for the contro] terminal associated with the process group of 
each process. It is useful for programs or shel] sequences that require written messages on the 
terminal, no matter how output has been redirected. It can also be used for programs that 
need the name of a file for output, when typed output is desired. 


FILES 
/dev/tty 
/dev/tty* 
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NAME | 
ud — general driver for all disk units supported by the M68KVM21 disk controller 


DESCRIPTION | 
Ud provides a general interface to M68KHDS32-1 (32Mb Cartridge Module Drive; refer to 
cm16(7)), M68KHDS50-1 (SOMb Lark Module Drive; refer to Irk25(7)), and the 
M68KHDS96-1 (Cartridge Module Drive; refer to cm8Q(7)). The driver can be modified to 
support other disk units compatible with the M68K VM21 controller. 


Drive dependent partitioning must be selected when the system is configured (con fig.68(1M)). 
Also, manual entries describing the above disk drives should be referred to for information 
regarding those particular drives. 


FILES 
/dev/dsk, /dev/rdsk 


_ SEE ALSO 


config.68(1M), master(4), cm16(7), cm80(7), £18(7), 1rk25(7). 
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NAME 
vl0graph - VME/10 graphics subsystem interface 


DESCRIPTION 
The VME/10 System Control Module (SCM) contains an MC68010, time-of-day clock with 
battery backup, a keyboard interface, an I/O Channel interface, a VMEbus interface, a color or 
monochrome video interface, and an operator panel interface. The 384Kb RAM in the SCM 
has the dual purpose of general software storage and graphics data storage. The RAM may be 
accessed by the MPU or by a VMEbus device; both the MPU and the VMEbus device use the 
SCM local bus to access RAM. 


If the gra phics(1G) program is not being used, all the RAM on the SCM is available as system 
RAM. In this mode, RAM appears at locations Ox00000 through OxSffff. If the graphics pro- 
gram is being used and the SCM is in low resolution graphics mode, system RAM appears at 
locations OxOO000 through Ox47fff, and the graphics RAM appears at locations 0x48000 
through OxS5ffff (96Kb). If the graphics program is being used and the SCM is in the high 
resolution graphics mode, system RAM appears at locations 0x00000 through Ox2ffff, and the 
graphics RAM appears at locations 0x30000 through OxSffff (192Kb). 


The graphics RAM is divided into three banks. Each bank is color for color monitors and an 
intensity for monochrome monitors. 


The graphics RAM block in the memory map is organized so that the first third of the graph- 
ics RAM locations is bank 3, the second third is bank 2, and the last third is bank 1. This 
allows the MPU to change 8 or 16 pixels at a time in one bank (color/intensity) on the screen. 


For example, if the monitor is a color monitor, then bank 3 is green, bank 2 is blue, and bank 
1 is red. When the graphics RAM is zeroed, the screen is blank. If the MPU, using word 
writes, sequentially fills the graphics RAM from the lowest address to highest address with 
Oxffff’s, the screen fills with green from top to bottom, 16 pixels at a time, until bank 3 is all 
f’s. Next, the screen fills with cyan (green and blue mixed) from top to bottom, 16 pixels at a 
time, until bank 2 is all f’s. Then, the screen fills with white (green, blue and red mixed) 
from top to bottom, 16 pixels at a time, until bank 1 is all f’s. This is useful when drawing 
bar graphs, color filling an object, or changing a background color. 


The graphics RAM is accessible in another mode, called the pixel access mode. In pixel access 
mode, read/write hardware enables the processor to change one pixel at a time in all three 
banks (in one memory cycle). The processor uses only word accesses, and writes a special 
pixel access word to addresses defined in non-existent memory. This mode is oriented toward 
drawing lines or changing a portion of the display. A 3-bit mask field allows the user to 
avoid disturbing the contents of a given plane (or planes) while changing the contents of 
another plane (or planes). It eliminates rewriting data into bank address when the data 
remains unchanged. The lower three bits of a pixel access word affect the three banks of the 
pixel, where bit 0 is bank 1, bit 1 is bank 2, and bit 2 is bank 3. Bits 3 through 7 and 11 
through 15 have no function, and bits 8 through 10 are mask bits. Bit 8, when low, disallows 
any effect by bit O on bank 1 of the pixel accessed. Bit 9, when low, disallows any effect by 
bit 1 on bank 2 of the pixel accessed. Bit 10, when low, disallows any effect by bit 2 on bank 
3 of the pixel accessed. Bits 8 through 10, when high, have no effect on their corresponding 
bank bit. For example, if the graphics RAM 1s zero, the screen is blank. If the MPU writes 
0x0707, starting at the lowest address of the pixel access block of the memory map to the 
highest address, the screen fills with white, one pixel at a time from top to bottom. The pixel 
access block appears at locations OxeQO000 through Oxe7ffff in low resolution graphics mode, 
and at locations Oxe00000 through Oxefffff in high resolution graphics mode. 


The VME/10 also includes 8Kb of static RAM for storage of user definable character sets and 
display attributes. The character generator RAM is initialized with the standard ASCII char- 
acter definitions, but can be modified by the user to define alternative symbols required by an 
application. The font is 8 x 16 in a 10 x 24 character field for the high resolution, 
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monochrome display, and 8 x 10 in a 10 x 12 character field for low resolution, color dislay. 
Characters or individual pixels can be displayed on any one of seven levels of grey scale on 
the monochrome display. For more information on the VME/10 hardware, refer to VME/10 
Micrvcom puter System System Control Module User's Manual. 


The fastest access to the VME/10 graphic subsystem is through shared memory, but the special 
shared memory segments must be at fixed addresses. This requirement necessitates a special 
system configuration and initialization. When the system is booted with a graphics kernel, 
196Kb of graphics RAM is automatically. reserved. All or part of this memory may be 
returned after the graphics driver determines which shared memory segments are to be pre- 
allocated, as configured in the graphics dfile. For more information on building and installing 
a graphics dfile and graphics kernel, refer to the SYSTEM V/68 Graphics Guide, "Installing 
Graphics.” If the dfile specifies that only the character and attribute shared segment is to be 
pre-allocated, 196Kb of RAM is returned to the coremap. If the dfile specifies that the banks’ 
area and pixel access area are to be pre-allocated, the resolution of the VME/10 is checked. If 
the VME/10 is in low resolution mode, 96Kb of RAM is returned to the coremap. If high 
resolution is set, 196Kb of RAM remains reserved. 


WARNING 


The resolution mode must be set by a TENbug Video Map (VM) command BEFORE 
the system is booted. For more information on the TENbug, refer to TENbug Debug- 
ging Package User’s Manual. 


User access to the VME/10 graphics subsystem is provided through shared memory system 
calls and the ioctl(2) system calls. These three segments are owned by root; read and write 
permissions are available for group users and all others. A user accesses a particular segment 
by issuing a shmget(2) with a pre-defined key for the segment, and then issues a shmat(2) 
system call with the shared memory identifier returned by the shmget system call. When a 
user is finished with the the shared memory segment, a shmdt(2) system call must be issued. 


The shmget system call has the form: 


int shmget(key, size, shmflg) 
key_t key 
int size, shmflg 


The predefined keys for shared memory graphics are: 


#define CGENKEY -1 /*character and attribute shared memory key*/ 
#define PIXKEY -2  /*pixel access area shared memory key*/ 
#define BANKKEY -3 /*color banks shared memory key*/ 


For normal shared memory segments, the size and shmflg are normally supplied by the user 
process. However, for the special segments, these values are not used since the ge have 
been pre-allocated. A recommended value for both of these arguments is 0. 


The shmat(2) system call attaches the shared memory segment associated with the shared 
memory identifier specified by shmid(2) to the data segment of the calling process. The seg- 
ment is attached at the address specified by shmaddr(2). 


The shmat system call has the form: 
char* shmat(shmid,shmaddr,shmflg) 
int shmid 
char *shmaddr 
int shmflg 
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The shmaddr value supplied in the user’s shmat(2) call will affect the speed of graphics out- 
put, due to the operation of the M68451 Memory Management Unit (MMU). The fewer MMU 
descriptors that are required to describe the segment, the less time spent in address translation 
by the MMU. Experimentation on the VME/10 shows that performance is enhanced if one of 
the constants listed below is selected for the input parameter, shmaddr, in the shmat(2) 
system call. 


Suggested Shmaddr Value for Color/Intensity Banks Shared Seg 


0x810000 (for high resolution only) 
0x818000 (for low resolution only) 


Suggested Shmaddr Value for Pixel Access Shared Memory Segment 


0x880000 (for high resolution only) 
| 0x 840000 (for low resolution only) 

Suggested Shmaddr Value for Character/Attribute Generator Shared Segment 
0x801000 (for both high and low resolution) 


The shmdt(2) system call detaches the shared memory segment from the calling process’s data 
segment. The shared memory segment is located at an address specified by shmaddr. 


The shmdt(2) system call has the form: 


int shmdt(shmaddr) 
char *shmaddr 


The shared memory segment used to access the color banks may be removed using the 
shmctl(2) call which frees the associated graphics memory, making it available for general 
system use. Once removed, graphics capability may be regained only by re-booting the system. 
In addition, access to the pixel access shared memory segment after the memory is released 
will have unpredictable and potentially disastrous effects. To protect against this possibility, 
the pixel access shared memory segment can be made unreadable and unwritable before the 
color bank segment is removed. 


The shared memory segments associated with the pixel access area and the character generator 
RAM should never be removed using the shmcti(2) call. Doing so will place the special 
hardware addresses into the available memory pool. The system may then try to load pro- 
grams or data into these areas, causing unpredictable behavior. 


The shmctl system call has the following form: 


int shmctl(shmid, cmd, buf) 
int shmid, cmd 
struct shmid_ds*buf 


To remove the shared memory identifier for a color/intensity bank segment, the cmd is 
IPC_RMID. Only the super user is permitted to free this segment. Shmctl can also be used to 
change the access permissions of the special segments. 


Access to some of the VME/10 graphic hardware registers has been provided through the 
ioctl(2) system call on the special device, /dev/v10graph. An open(2) system call on this 
device returns a file descriptor. This file descriptor is necessary for the toctl system calls for 
graphics. 
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Control register O and control register 1 affect the display of graphics. Control register 0 is 
cleared to 0 when any of the four VME/10 reset conditions occur. Control register 1 is cleared 
to O only when the power-on-reset condition occurs. Control registers 0 and 1 are writable 
and readable by the MPU when it is in the user state. However, the data read is not reliable 
unless the control register has been written to by the Pent at least once since the last 
reset condition occurred. 


The MC6845 (CRTC) registers and the graphics offset registers have fixed values for high and 
low resolution graphics display. The ioctl commands SETHIRES and SETLORES set these 
registers at their fixed values. 


Two separate registers control horizontal and vertical cursor display. The vertical graphics 
cursor register is set to display a vertical line on the screen. The horizontal graphics cursor 
register is set to display a horizontal line on the screen. 


The graphics ioctl calls use the following structure types, defined in sys/v10gr.h: 


typedef struct { 
unsigned char cdis:3; 
unsigned char curbk:1; 
unsigned char dutycycle:1; 
unsigned ivs:1; 
unsigned char 2 
} v10_cr0; 


The values of the bit fields are: 

cdis:3 Character disable: This 3-bit field disables the 
display of the red/green/blue portions of the 
character. Permissible values range from 0 to 
7 where: 


QO1 disables red portion of the character 
010 disables blue portion of the character 
100 disables green portion of the character 


curbk:1 Cursor blink: The character cursor will 
blink when set(1) and will be steady when 
reset(O). 

dutycycle:1 Display dutycycle: This bit selects the 


display dutycycle of 50% when set(1) and 
100% when reset(0). When high, this bit will 
prevent every other dot on each line from 
being displayed. This prevents horizontal 
lines, such as those in the letter B, from stand- 
ing out more than non-horizontal lines, such as 
those in the letter X. 


ivs:1 Invert video screen: When set(1), all charac- 
ters on the screen are inverted. When low, all 
characters are normal. 


2 An unnamed bit field. These bit f ields are not 
used for graphics. 
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typedef struct 


} v10_crl: 
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{ 


unsigned char a 
unsigned char sel:2; 
unsigned char hires; 
unsigned gre:3; 
unsigned char 71 


The values of the bit fields are: 


a | 


sel:2 


hires:1 


gre:3 


typedef struct 


An unnamed bit field. This bit field is not 
used for graphics. 

Character cursor: This field selects the style 
of character cursor. It may be any value from 
0 to 3. 

High resolution: This bit field is read-only. 
Memory has been mapped to high resoluton 
when set(1) and mapped to low resolution 
when reset(0). 

Graphics enable: This bit field enables the 
display of graphics in each of the three color 
banks. Permissible values range from 0 to 7 
where: 


001 enables graphics in color bank 1 (red) 
010 enables graphics in color bank 2 (blue) 
100 enables graphics in color bank 3 (green) 


An unnamed bit field. This bit field is not 
used for graphics. 


{ 


short h; 
short Vv; 
1 y10_cursor; 
h Horizontal line positioning: This 16-bit field 


will move the horizontal component of the 
cursor top to bottom for 300 positions. 


Oxff ff (-1) is the top-most position. 
Oxfed4 (-300) is the bottom-most position. 


0 turns off the horizontal component of 
the cursor. 
Vv Vertical line positioning: This 16-bit field 


will move the vertical component of the cur- 
sor left to right for 800 positions. 


Oxff ff (-1) is the left-most position. 
Oxfed4 (-800) is the right-most position. 


0 


turns off the vertical component of the 


Cursor. 
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The VME/10 graphics kernel supports 6 ioctl commands for controlling the display hardware 


These commands and the type of argument they require are listed below: 


#include <sys/v10gr.h> 
ioctl(fildes, command, arg) 
v10_crO *arg; 


The commands using this form are: 


SETCRO — Set the contents of control register 0. 
GETCRO _ Get the contents of control register 0. 


#include <sys/v10gr.h> 
ioctl(fildes, command, arg) 
v10_cr1 *arg; 


The commands using this form are: 


SETCR1 Set the contents of control register 1. 
GETCR1 Get the contents of control register 1. 


#include <sys/v1l0gr.h> 
ioctl(fildes, command, arg) 
v10_cursor "arg; 


The commands using this form are: 


SETCUR Set the contents of the cursor registers. 


GETCUR _ Get the contents of the cursor registers. 


#include <sys/vi10gr.h> _ 
ioctl(fildes, command, NULL) 


The commands using this form are: | 
SETLORES Change the CRTC registers and graphics offset registers to standard 


low resolution values. 


SETHIRES Change the CRTC registers and graphics offset registers to defaults 


for high resolution values. 


It should be noted that this command changes the resolution of the display only and does not 
affect the mapping of memory. The default resolution of the display at system initialization 
is low resolution. 


FILES 


/dev/v10graph dfile 


SEE ALSO 
graph(1G), 


ioctl(2), shmget(2), shmat(2), shmdt(2), shmctl(2) 
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NA ME 
vm21 — default general driver for all disk units supported by the M68KVM21 disk con- 
troller 

DESCRIPTION 
Vm21 provides a general interface to M68KHDS32-1 (32Mb Cartridge Module Drive), 
M68KHDSSO-1 (SOMb Lark Module Drive), M68KHDS16-1 (16Mb Lark Module Drive), and 
M68KHDS96-1 (Cartridge Module Drive). The driver can be modified to support other disk 
units compatible with the M68KVM21 controller. 


Drive dependent partitioning must be selected when the system is configured (con fig(1M)). 
Manual entries describing the above disk drives should be referred to for information regard- 
ing those particular drives. The partitioning and driver provide a mechanism for software bad 
track replacement. This set supercedes the ud(7) driver and disk drive partitioning. 


The vm21 accepts ioctK2) calls of the form: 
ioctl ( fildes, command, arg) 
int arg; 
The following command is available: 
UDFMT: Formats the track starting at the block number specified in arg. 
FILES 
/dev/dsk/s, /dev/rdsk/* 
SEE ALSO 
cmd16(7), cmd807), lark25(7), lark 8(7), sa800f121(7) 
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NA ME 
_vm22 — default general driver for all disk units supported by the M68KVM22 disk con- | 


troller 


DESCRIPTION 


FILES 


Vm22 provides a general interface to M68KHDS32-1 (32Mb Cartridge Module Drive), 
M68KHDSS0-1 (SOMb Lark Module Drive), M68KHDS16-1 (16Mb Lark Module Drive), and 
M68KHDS96-1 (Cartridge Module Drive). The driver can be modified to support othe disk 
units compatible with the M68K VM22 controller. 


Drive dependent partitioning must be selected when the system is configured (con fig(1M)). 
Manual entries describing the above disk drives should be referred to for information regard- 
ing those particular drives. The partitioning and driver provide a mechanism for software bad 
track replacement. 


Primary ioctl(2) system calls accepted by vm22 are of the form: 


ioctl( fildes,command arg) 
struct vm22config *arg — 


As defined in the include file <vm22.h>, commands using this form are: 


VM22GET: Gets the configuration information associated with the drive and places it into 
the location specified by arg. 


VM22SET: Sets the drive’s configuration to that specified by the arg parameter. This 
command will execute a vm22 controller “configure” command. 


Additional iocti(2) calls have the form: 


ioctl (fildes, command, arg) 
int arg; 


As defined in <vm22.h>, commands using this form are: 
VM22FMTT: Formats the track starting at the block number specified in arg. 
VM22FMTU: Formats the entire logical unit. 


/dev/dsk/s, /dev/rdsk/s 


SEE ALSO 


cmd16(7), cmd80(7), lark25(7), lark 8(7), sa800f122(7), sa400f122(7), ioctl(2). 
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NAME 
wdl15 — 15Mb Winchester Disk Drive 


DESCRIPTION 
The files dsk/cntrir_0s0 ... dsk/cntrir_Os7 refer to sections of the wd15 disk drive 0. The 
files dsk/cntrir_1s0 ... dsk/cntrir_1s7 refer to sections of drive 1. This slicing allows the dev- 
ice to be broken up into more manageable pieces. 


The origin and size of the sections on each drive are as follows: 


section _ Start length 


0 192 24504 
] 7056 =21168 
2 10584 17640 
3 14112 = 14112 
4 17640 10584 
3 21168 7056 
6 24696 3528 
7 QO 28224 


Slice 0 follows a 192-block reserved area used for tables and tracks for disk diagnostics. 


The start address is a block address, with each block containing 512 bytes. It is extremely 
unwise for all of these files to be present in one installation because there is overlap in 
addresses, and protection becomes a problem. 


The dsk/* files access the disk via the system’s normal buffering mechanism and may be read 
and written without regard to physical disk records. There is also a “raw” interface which 
provides for direct transmission between the disk and the user’s read or write buffer. A sin- 
gle read or write call results in exactly one I/O operation and therefore raw I/O is consider- 
ably more efficient when many words are transmitted. The names of the raw files begin with 
rdsk and end with a number which selects the same disk section as the corresponding dsk 
file. 


In raw I/O the buffer must begin on a word boundary, and counts must be a multiple of 512 
bytes (a disk block). Likewise, /seek(2) calls should specify a multiple of 512 bytes. 
FILES | 
/dev/dsk/*, /dev/rdsk/* 


SEE ALSO 
cm16(7), cm80(7), 18(7), id(7), I1rk25(7), m320(7), ud(7), wd40(7). 


ate 
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NAME 
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wd40 — 40Mb Winchester Disk Drive 


DESCRIPTION 


The files dsk/cnitrir_0s0 ... dsk/cntrir_0Qs7 refer to sections of the wd40 disk drive 0. The 
files dsk/cntrir_1s0 ... dsk/cntrir_1s7 refer to sections of drive 1. This slicing allows the dev- 
ice to be broken up into more manageable pieces. 


The origin and size of the sections on each drive are as follows: 


section _ Start length 
0 192 77328 
1 18792 58728 
2 24192 53328 
3 28224 49296 
4 38640 38880 
5 46824 30696 
6 63072 14448 
7 0 77520 


FILES 


Slice 0 follows a 192-block reserved area used for tables and tracks for disk diagnostics. 


The start address is a block address, with each block containing 512 bytes. It 1s extremely 
unwise for all of these files to be present in one installation because there is overlap in 
addresses and protection becomes a problem. 


The dsk/* files access the disk via the system’s normal buffering mechanism and may be read 
and written without regard to physical disk records. There is also a “raw” interface which 
provides for direct transmission between the disk and the user’s read or write buffer. A sin- 
gle read or write call results in exactly one I/O operation and therefore raw I/O is consider- 
ably more efficient when many words are transmitted. The names of the raw files begin with 
rdsk and end with a number that selects the same disk section as the corresponding dsk file. 


In raw I/O the buffer must begin on a word boundary, and counts must be a multiple of 512 
bytes (a disk block). Likewise, /seek(2) calls should specify a multiple of 512 bytes. 


/dev/dsk/*, /dev/rdsk/* 


SEE ALSO 


1d(7), wd15(7), m320(7). 
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NAME 
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wd70 — 70Mb Winchester Disk Drive 


DESCRIPTION 


FILES 


The files dsk/cntrir_0s0 ... dsk/cntrir_Os7 refer to sections of the wd70 disk drive 0. The 
files dsk/cntrir_1s0 ... dsk/cntrir_1s7 refer to sections of drive 1. This slicing allows the dev- 
ice to be broken up into more manageable pieces. 


The origin and size of the sections on each drive are as follows: 


section start length 
0 1280 128640 
] 28160 101760 
2 45440 84480 
3 60800 69120 
4 76160 53760 
5 92160 37760 
6 111360 18560 
7 0 130944 


Slice 0 follows a 1280-block reserved area used for drive-specific tables and tracks for disk 
diagnostics. 


The start address is a block address, with each block containing 512 bytes. It is extremely 
unwise for all of these files to be present in one installation because there is overlap in 
addresses and protection becomes a problem. 


The dsk/* files access the disk via the system’s normal buffering mechanism and may be read 
and written without regard to physical disk records. There is also a “raw” interface which 
provides for direct transmission between the disk and the user’s read or write buffer. A sin- 
gle read or write call results in exactly one I/O operation and therefore raw I/O is consider- 
ably more efficient when many words are transmitted. The names of the raw files begin with 
rdsk and end with a number that selects the same disk section as the corresponding dsk file. 


In raw I/O the buffer must begin on a word boundary, and counts must be a multiple of 512 
bytes (a disk block). Likewise, /seek(2) calls should specify a multiple of 512 bytes. 


/dev/dsk/#*, /dev/rdsk/* 


SEE ALSO 


sa400flwd(7), wd15(7), wd40(7). 


? OOflwd(7), wd15(7), wd40(7). 
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NAME 
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wd140 — 140Mb Winchester Disk Drive 


DESCRIPTION 


FILES 


The files dsk/cntrir_0s0 ... dsk/cntrir_Qs7 refer to sections of the wd140 disk drive 0. The 
files dsk/cntrir_1s0 ... dsk/cntrir_1s7 refer to sections of drive 1. This slicing allows the dev- 
ice to be broken up into more manageable pieces. 


The origin and size of the sections on each drive are as follows: 


section start length 
0 1680 217200 
1 32400 186480 
2 64800 154080 
3 93600 125280 
4 122400 96480 
5 151200 67680 
6 180000 38880 
7 Q 220320 


Slice 0 follows a 1680-block reserved area used for drive-specific tables and tracks for disk 
diagnostics. 


The start address is a block address, with each block containing 512 bytes. It is extremely 
unwise for all of these files to be present in one installation because there is overlap in 
addresses and protection becomes a problem. 


The dsk/* files access the disk via the system’s normal buffering mechanism and may be read 
and written without regard to physical disk records. There is also a “raw” interface which 
provides for direct transmission between the disk and the user’s read or write buffer. A sin- 
gle read or write call results in exactly one I/O operation and therefore raw I/O 1s consider- 
ably more efficient when many words are transmitted. The names of the raw files begin with 
rdsk and end with a number that selects the same disk section as the corresponding dsk file. 


In raw I/O the buffer must begin on a word boundary, and counts must be a multiple of 512 
bytes (a disk block). Likewise, /seek(2) calls should specify a multiple of 512 bytes. 


/dev/dsk/#, /dev/rdsk/* 


SEE ALSO 


sa400flwd(7), wd15(7), wd40(7), wd70(7). 


zie 
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NAME 
intro — introduction to system maintenance procedures 
DESCRIPTION 


This section outlines procedures for those charged with the task of system maintenance. 
Included are discussions on boot procedures, recovery from crashes, and file backups. 
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NA ME 
bo.macs — bootstrap operating procedure for system restart on EXORmacs 
SYNOPSIS 
bo [<device>] [,<controller>] [,<string>] 
Options | 
device a single hexadecimal digit (O-F) specifying the device to be used (default = 0). 
controller  asingle hexadecimal digit (O-F) specifying the controller to which the device is 
connected (default = 0). 
string an optional ASCII character string (maximum of 18 characters) that is passed 
to the program being loaded from the specified device and controller. This 
string may be the pathname of the SYSTEM V/68 program to be booted (default 
= /stand/unix). 
DESCRIPTION 


When the system is turned on, the front panel status should be 01. Perform the system self- 
test by holding the system reset and the system test buttons depressed. Release first the sys- 
tem reset button and then release the system test button. The status changes to EA while 
memory is initialized, then to 01 when the test is complete. The prompt P* appears after the 
Return key is pressed. After receiving the prompt, type: bo (drive O is the default and 
accesses the fixed media). If the system resides on the removable media, type: bo 1 (drive 1 is 
accessed). The CRT displays: 


INIT: SINGLE USER MODE 
# 


Enter: init 2 
The CRT displays: 


INIT: New run level: 2 
Is the date <day> <month> <date> <time> <year> correct? (y or n) 


If the date is incorrect, type: m and set the date and time. For the correct date and time, the 
following format is required: mmddhhmml[yy], where mm=month, dd=day, hh=hour, 
mm=minute, yy=year (refer to date(1)). For example: 


Sept. 28, 1983 at 7:30am is 0928073083 
If the date is correct, type: y ; the CRT displays: 
Do you want to check the file system? (y or n) 


To prevent possible system damage, a file system check is recommended. Enter: y . The fol- 
lowing is an example of a file system check display: 


/dev/dsk/vm21_1s0 
File System: /dO Volume: fixed 
** Phase 1 - Check Blocks and Sizes 
** Phase 2 - Check Pathnames 
** Phase 3 - Check Connectivity 
** Phase 4 - Check Reference Counts 
** Phase 5 - Check Free List <n> files <n> blocks <n> free 
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**¥SYSTEM MULTI-USER <day> <month> <date> <time> < year>*** 
If a file system check is not required, enter: n ; the "SYSTEM MULTI-USER" display is printed. 


A login prompt now appears on activated CRT terminals. 
FILES 
/stand/unix 
SEE ALSO 
date(1), fsck(1M), init(1M), ops.macs(8). 


WARNINGS 
Memory initialization must be completed before this boot procedure is used. 
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NA ME 
bo.vme — bootstrap operating procedure for system restart on VME/10 


SYNOPSIS 
bo [<device>] [,<controller>] [,<string>] 


Options 

device a single hexadecimal digit (O-F) specifying the device to be used (default = 0). 

controller a single hexadecimal digit (O-F) specifying the controller to which the device is 
connected (default = 0). | 

string an optional ASCII character string (maximum of 18 characters) that is passed 
to the program being loaded from the specified device and controller. This 
string may be the pathname of the SYSTEM V/68 program to be booted (default 
= /stand/unix). 

DESCRIPTION 


When the system is turned on and the KYBD LOCK switch is in the horizontal position, the 
system self-test is automatically performed. The first message to appear will be: 

Power-up test in progress. 

Waiting for disk to spin up. 
After the message 

Power-up test complete. 
has been received, the TENbug prompt will appear. This prompt should be: 

TENbug 2.0 > | 
If the serial port (MVME400) is connected, however, the prompt that will appear on the 
screen 1s: 

TEN bug 
Type a carriage return to obtain the TENbug 2.0 > prompt. If theTENbug 2.0 > prompt 
does not appear, unplug the serial port, press the RESET button, and boot the system before 
plugging in the serial port again. 
After receiving the prompt, type: bo (drive 0 is the default and accesses the fixed media). If 
the system resides on the removable media, type: bo 1 (drive 1 is accessed). The CRT 
displays: 


INIT: SINGLE USER MODE 
# 


Enter: init 2 
The CRT displays: 


INIT: New run level: 2 
Is the date <day> <month> <date> <time> <year> correct? (y or n) 


If the date is incorrect, type: mn and set the date and time. For the correct date and time, the 
following format is required: mmddhhmml[yy], where mm=month, dd=day, hh=hour, 
mm=minute, yy=year (refer to date(1)). For example: 

Sept. 28, 1983 at 7:30am is 0928073083 
If the date is correct, type: y ; the CRT displays: 


Do you want to check the file system? (y or n) 
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To prevent possible system damage, a file system check is recommended. Enter: y . The fol- 
lowing is an example of a file system check display: 


/dev/dsk/wd_1s0 
File System: /dO Volume: fixed 
** Phase 1 - Check Blocks and Sizes 
** Phase 2 - Check Pathnames 
** Phase 3 - Check Connectivity 
** Phase 4 - Check Reference Counts 
** Phase 5 - Check Free List <n> files <n> blocks <n> free 


*EXSYSTEM MULTI-USER <day> <month> <date> <time> <year>*** 
If a file system check is not required, enter: n ; the "SYSTEM MULTI-USER" display is printed. 


A login prompt now appears on activated CRT terminals. 
FILES 
/stand/unix 
SEE ALSO 
date(1), fsck(1M), init(1M). 
WARNINGS 
Memory initialization must be completed before this boot procedure is used. 
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NA ME 
crash — what to do when the system crashes 


DESCRIPTION 
This entry gives at least a few clues about how to proceed if the system crashes. It can’t pre- 
tend to be complete. 


In restarting after a crash, always bring up the system single-user, aS specified in bo.macs (8) 
for the EXORmacs Development System or bo.vme(8) for the VME/10, as modified for your 
particular installation. Then perform an fsck(1M) on all file systems that could have been in 
use at the time of the crash. If any serious file system problems are found, they should be 
repaired. When you are Satisfied with the health of your disks, check and set the date if 
necessary, then come up multi-user. 


To even boot the SYSTEM V/68 at all, three files (and the directories leading to them) must be 
intact. First, the initialization program /etc/init must be present and executable. For init to 
work correctly, /dev/console and /bin/sh must be present. If either does not exist, the 
symptom is best described as thrashing. Jnit goes into a fork/exec loop trying to create a 
shell with proper standard input and output. 


If you cannot get the system to boot, a runnable system must be obtained from a backup 
medium. The root file system may then be doctored as a mounted file system as described 
below. If there are any problems with the root file system, it is probably prudent to go to a 
backup system to avoid working on a mounted file system. 


Re pairing disks. The first rule to keep in mind is that a disk in need of repair should be 
treated gently; it shouldn’t be mounted unless necessary, and if it is very valuable yet in quite 
bad shape, perhaps it should be copied before trying surgery on it. 


Fsck (1M) is adept at diagnosing and repairing file system problems. It first identifies all of 
the files that contain bad (out of range) blocks or blocks that appear in more than one file. 
Any such files are then identified by name and fsck requests permission to remove them 
from the file system. Files with bad blocks should be removed. In the case of duplicate 
blocks, all of the files except the most recently modified should be removed. The contents of 
the survivor should be checked after the file system is repaired to ensure that it contains the 
proper data. (Note that running fsck with the —n option causes it to report all problems 
without attempting any repair.) 


Fsck also reports on incorrect link counts and requests permission to adjust any that are 
erroneous. In addition, it reconnects any files or directories that are allocated but have no file 
system references to a “lost+found” directory. Finally, if the free list is bad (out of range, 
missing, or duplicate blocks) fsck constructs a new one, with the operator’s concurrence. 


Why did it crash? SYSTEM V/68 types a message on the console when a crash occurs. Here is 
the current list of such messages, with enough information to provide a possible remedy. The 
message has the form “panic: ...”, usually accompanied by other information. Left unstated in 
all cases is the possibility that hardware or software error produced the message in some 
unexpected way. 


blkdev 
The getblk routine was called with a nonexistent major device as argument. Definitely 
hardware or software error. 

devtab | | 
Null device table entry for the major device used as argument to getblk. Definitely 
hardware or software error. . 

linit 
An I/O error reading the superblock for the root file system during initialization. 
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no fs 
A device has disappeared from the mounted-device table. Definitely hardware or 
software error. 


no imt 
Similar to “no fs”, but produced elsewhere. 


no clock 
During initialization, neither the line nor programmable clock was found to exist. 


I/O error in swap 
An unrecoverable I/O error during a swap. This shouldn’t be a panic, but it is hard to 
fix. 


out of swap space 
A program needs to be swapped out, and there is no more swap space. It has to be 
increased. This shouldn’t be a panic, but there is no easy fix. 


trap 
An unexpected trap has occurred within the system. This is accompanied by three 
numbers: a “ps”, which is the user’s stack pointer; “pc”, which is the user’s program 
counter; and a “trap type” that encodes which trap occurred. The trap types are: 


bus error 

address error 

illegal instruction 

zero divide fault 

CHK instruction fault 
TRAPV instruction fault 


privileged instruction fault 
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trace trap 


=" 
am) 


line 1010 emulator 

11 _ line 1111 emulator 

24 spurious interrupt 

32 TRAP 0 - system call 

33 TRAP 1 - breakpoint 

34 TRAP 2 - simulate DEC IOT instruction 
35 TRAP 3 - simulate DEC EMT instruction 
36 TRAP 4 - floating point exception 


In some of these cases it is possible for hexadecimal 200 to be added into the trap type; this 
indicates that the processor was in user mode when the trap occurred. If you wish to examine 
the stack after such a trap, dump the system. 


Interpreting dumps. (NOTE: This section does not apply for the VME/10.) All file system 
problems should be taken care of before attempting to look at dumps. The dump should be 
read into the file /usr/tmp/core; cp(1) can be used. At this point, you should execute ps 
—el —c /usr/tmp/core and who to print the process table and a list of the users who were 
on at the time of the crash. 


SEE ALSO 
crash(1M), fsck(1M), bo.macs(8), ops.macs(8), bo.vme(8). 
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NA ME 
mk — how to remake the system and commands 


DESCRIPTION | 
All source for SYSTEM V/68 is in a source tree distributed in the directory /usr/src. This 
includes source for the operating system, libraries, commands, miscellaneous files necessary to 
the running system, and procedures to create everything from this source. 


The top level consists of the directories cmd, lib, uts, head, and stand as well as commands 
to remake each of these directories. These commands are named :mk, which remakes every- 
thing, and :mkdir where dir is the directory to be recreated. Each recreation command 
makes all or part of the piece; over which it has control. :mk runs each of these commands 
and thus recreates the whole system. 


The lib directory contains libraries used when loading user programs. The largest and most 
important of these is the C library. All libraries are in sub-directories and are created by a 
makefile or runcom. A runcom is a shell command procedure used specifically to remake a 
piece of the system. :mklib rebuilds the libraries that are given as arguments. The argument 
\* causes it to remake all libraries. 


The head directory contains the header files, usually found in /usr/include on the running 
system. :mkhead installs those header files that are given as arguments. The argument \s 
causes it to install all header files. 


The uts directory contains the source for the operating system. -:mkuts (no arguments) 
invokes a series of makefiles that recreate the operating system. 


The stand directory contains stand-alone commands and boot programs. :mkstand rebuilds 
and installs these programs. 


The cmd directory contains files and directories. :mkcmd transforms source into a command 
based upon its suffix (.1, .y, .c, .s, ssh), or its makefile (see make(1)) or runcom. A directory is 
assumed to have a makefile or a runcom that takes care of creating everything associated with 
that directory and its sub-directories. Makefiles and runcoms are named command .mk and 
command .rc respectively. 


smkcmd recreates commands based upon a makefile or runcom if one of them exists; alterna- 
tively commands are recreated in a standard way based on the suffix of the source file. All 
commands requiring more than one file of source are grouped in sub-directories, and must 
have a makefile or a runcom. C programs (.c) are compiled by the C compiler and loaded 
stripped with shared text. Assembly language programs (.s) are assembled with 
/usr/include/sys.s which contains the system call definitions. Yacc programs (.y) and lex 
programs (.1) are processed by yacc(1) and lex(1) respectively before C compilation. Shell 
programs (.sh) are copied to create the command. Each of these operations leaves a command 
in ./cmd which is then installed by using /etc/install. 


The arguments to :mkcmd are either command names, or subsystem names. The subsystems 
distributed with SYSTEM V/68 are: acct, graf, sccs, and text. Prefacing the :mkcmd instruc- 
tion with an assignment to the shell variable $ARGS causes the indicated components of the 
subsystem to be rebuilt. 


The entire sccs subsystem can be rebuilt by: 
/usr/src/:mkcmd_ sccs 

while the delta component of sccs can be rebuilt by: 
ARGS="delta” /usr/src/:mkcmd sccs 


The log command, which is a part of the stat package, which is itself a part of the graf 
package, can be rebuilt by: 
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ARGS="stat log” /usr/src/:mkcmd graf 
The argument \* causes all commands and subsystems to be rebuilt. 


Makefiles, both in ./cmd and in sub-directories, have a standard format. In particular 
:mkcmd depends on there being entries for install and clobber. Install should cause every- 
thing over which the makefile has jurisdiction to be made and installed by /etc/install. 
Clobber should cause a complete cleanup of all unnecessary files resulting from the previous 
invocation. 


Most of the runcoms in ./cmd (as opposed to sub-directories) relate in particular to a need for 
separated instruction and data (I and D) space. 


Ctime checks the environment (see environ(5)) for the time zone. This results in time zone 
conversions possible on a per-process basis. /etc/profile sets the initial environment for each 
user, and /etc/rc sets it for certain system daemons. These two programs are the only ones 
which must be modified outside of the eastern time zone. 


An effort has been made to separate the creation of a command from source, and its installa- 
tion on the running system. The command /etc/install is used by :mkcmd and most 
makefiles to install commands in the proper place on the running system. The use of install 
allows maximum flexibility in the administration of the system. Install makes very few 
assumptions about where a command is located, who owns it, and what modes are in effect. 
All assumptions may be overridden on invocation of the command, or more permanently by 
redefining a few variables in install. The object is to install a new version of a command in 
the same place, with the same attributes as the. prior version. 


In addition, the use of a separate command to perform installation allows for the creation of 
test systems in other than standard places, easy movement of commands to balance load, and 
independent maintenance of makefiles. The minimization of makefiles in most cases, and the 
site independence of the others should greatly reduce the necessary maintenance, and allow 
makefiles to be considered part of the standard source. 


SEE ALSO 
install(1M), make(1). 
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NAME 
ops.macs — EXORmacs operations 


DESCRIPTION | 
The procedures described include the major operational sequences involved in running 
SYSTEM V/68 on the EXORmacs. 


INSTALLATION BOOT PROCEDURES 
Refer to “Setting Up SYSTEM V/68” in the SYSTEM V/68 Administrator's Guide. 


DAILY PROCEDURES 
DISK BOOT 


For system restart, refer to: bo.macs(8). 
BRINGING THE SYSTEM DOWN 


The shutdown procedure is designed to turn off all processes and bring the system back to sin- 
gle user state with all buffers flushed. To do this the operator should execute shutdown(1M). 
If shutdown is not successful, use the following sequence of commands: 


killall 

sync 

telinit S 

fsck (optional) 
sync 

sync 


The system may then be halted by pressing the RESET button on the chassis. 
SYSTEM DUMPS 
After a crash, the following procedure should be used to get a system dump: 


1. Press the SOFTWARE ABORT button on the EXORmacs (pressing the SYSTEM RESET 
button also works, but it destroys all of the system interrupt vectors). The prompt P* appears. 


2. Enter: 
g 400 . 
This starts the dump. After a short period of time, the system responds with: 
Dump complete. dd skip=xxx, dd count=yyy 
where xxx and yyy are decimal numbers (of blocks) to be used later. 
If the system responds instead with: 
I/O error during dump 


then some type of I/O error has occurred. Try pressing the SYSTEM RESET button and re- 
enter g 400 . If the error message appears a second time, consult local lab support personnel. 


3. Press the SYSTEM RESET button and boot the system (see bo.macs(8)). DO NOT enter 
init 2 when the system comes up; remain in Single User mode. 


Should the system not come up, refer to crash.macs(8) for additional information. 


4. If the root file system does not have sufficient room for the core dump (at least yyy blocks 
free), then a file system with enough room has to be mounted. Refer to mount(1M). 


5. If the number yyy from Step 2 is larger than 2048, then the maximum writable file size 
has to be increased in order to save the system dump. To increase file size, enter: ulimit n 
where n = whatever size is sufficient. For example: 
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ulimit 32768 
The size should be at least yyy. 


6. Since the dump was written to the system swap area, it must be saved in a file for later 
analysis. To save the dump in a file, enter: 


dd if=/dev/swap of=/ilename skip=xxx count=yyy 


where name is the name of the file that receives the dump; xxx and yyy are the numbers 
from Step 2. If xxx is 0, then the skip parameter does not have to be included on the dd com- 
mand line. 


7. If a file system was mounted in Step 4, unmount it now. Refer to umount in mount(1M). 
8. Check the file system by running fsck(1M). 
9. Boot the system normally (see bo.macs(8)), assuming fsck completed normally. 


10. Once the system is back up, the following command starts crash(1M) so that the dump 
can be analyzed: 


/etc/crash /fixed/ filename 


SYSTEM FAULTS 


Refer to MACSbug Monitor Re ference Manual (M68KMACSBG). 
FILES 

/etc/shutdown 

/stand/* 


SEE ALSO 
date(1), dd(1), fsck(1M), init(1M), shutdown(1M), sync(1), bo.macs(8), EXORmacs Chassis 
User's Guide(M68KCHAS), MACSbug Monitor Re ference Manual(M68KMACSBG), “Setting 
Up SYSTEM V/68” in the SYSTEM V/68 Administrator's Guide(M68KUNAG). | 


USER’S COMMENTS 
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Product Code 72900 
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Motorola welcomes your comments and suggestions. Please use this form. 


eDoes this manual provide the information you need? OYes ONo 


— What is missing? 


eis the manual accurate? OYes ONo 


— What is incorrect? (Be specific.) 


els the manual written clearly? O Yes ONo 


— What is unclear? (Be specific.) 
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e What do you like about this manual? 


e Was this manual difficult to obtain? OYes ONo 
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Name 
Company 
Address 
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